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PREFACE 


This update to the fourth distribution of November 1980 provides support for the VAX 11/750 and for 
the full interconnect architecture of the VAX 11/780. Robert Elz of the University of Melbourne contri- 
buted greatly to this distribution especially in the boot-time system configuration code; Bill Shannon of 
DEC supplied us with the implementation of DEC standard bad block handing. The research group at 
Bell Laboratories and DEC Merrimack provided us with access to 11/750’s in order to debug its support. 


Other individuals too numerous to mention provided us with bug reports, fixes and other enhancements 


which are reflected in the system. We are ever grateful to the UNIX user community for encouragement 
and support. 


The financial support of the Defense Advanced Research Projects Agency in support of this work is 
gratefully acknowledged. 


WN. Joy 
R. S. Fabry 
K. Sklower 


Preface to the Fourth Berkeley distribution 


This manual reflects the Berkeley system mid-October, 1980. A large amount of tuning has been done in 
the system since the last release; we hope this provides as noticeable an improvement for you as it did for 
us. This release finds the system in transition; a number of facilities have been added in experimental 
versions (job control, resource limits) and the implementation of others is imminent (shared-segments, 
higher performance from the file system, etc.). Applications which use facilities that are in transition 
should be aware that some of the system calls and library routines will change in the near future. We 
have tried to be conscientious and make it very clear where this ts likely. 


A new group has been formed at Berkeley, to assume responsibility for the future development and sup- 
port of a version of UNIX on the VAX. The group has received funding from the Defense Advanced 
Research Projects Agency (DARPA) to supply a standard version of the system to DARPA contractors. 
The same version of the system will be made available to other licensees of UNIX on the VAX for a 
duplication charge. We gratefully acknowledge the support of this contract. 


We wish to acknowledge the contribution of a number of individuals to the the system. 


We would especially like to thank Jim Kulp of IIASA, Laxenburg Austria and his colleagues, who first 
put job control facilities into UNIX, Eric Allman, Robert Henry, Peter Kessler and Kirk McKusick, who 
contributed major new pieces of software; Mark Horton, who contributed to the improvement of facilities 
and substantially improved the quality of our bit-mapped fonts, our hardware support staff: Bob Kridle., 
Anita Hirsch, Len Edmondson and Fred Archibald, who helped us to debug a number of new peri- 
pherals; Ken Arnold who did much of the leg-work in getting this version of the manual prepared, and 
did the final editing of sections 2-6, some special individuals within Bell Laboratories: Greg Chesson, 
Stuart Feldman, Dick Haight, Howard Katseff, Brian Kernighan, Tom London, John Reiser, Dennis 
Ritchie, Ken Thompson, and Peter Weinberger who helped out by answering questions, our excellent 
local DEC field service people, Kevin Althaus and Frank Chargois who kept our machine running virtu- 
ally all the time, and fixed it quickly when things broke; and, Mike Accetta of Carnegie-Mellon Univer- 
sity, Robert Elz of the University of Melbourne, George Goble of Purdue University, and David Kashtan 
of the Stanford Research Institute for their technical advice and support. 
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Special thanks to Bill Munson of DEC who helped by augmenting our computing facility and to Eric All- 
man for carefully proofreading the “‘last’’ draft of the manual and finding the bugs which we knew were 
there but couldn’t see. 


We dedicate this to the memory of David Sakrison, late chairman of our department, who gave his sup- 
port to the establishment of our VAX computing facility, and to our department as a whole. 


W.N. Joy 
O. Babaoglu 
R. S. Fabry 
K. Sklower 


Preface to the Third Berkeley distribution 


This manual reflects the state of the Berkeley system, December 1979. We would like to thank all the 
peopie at Berkeley who have contributed to the system, and particularly thank Prof. Richard Fateman for 
creating and administrating a hospitable environment, Mark Horton who helped prepare this manual, and 
Eric Allman, Bob Kridle, Juan Porcar and Richard Tuck for their contributions to the kernel. 


The cooperation of Bell Laboratories in providing us with an early version of UNIX/32V is greatly appreci- 
ated. We would especially like to thank Dr. Charles Roberts of Beil Laboratories for helping us obtain 
this release, and acknowledge T. B. London, J. F. Reiser, K. Thompson, D. M. Ritchie, G. Chesson and 
H. P. Katseff for their advice and support. 


W.N. Joy 
O. Babaoglu 


Preface to the UNIX/32V distribution 


The UNIX? operating system for the VAX*-11 provides substantially the same facilities as the UNIX system 
for the PDP*-1L1. 


We acknowledge the work of many who came before us, and particularly thank G. K. Swanson, W. M. 
Cardoza, D. K. Sharma, and J. F. Jarvis for assistance with the implementation for the VAX-11/780. 


T. B. London 
J. F. Reiser 


Preface to the Seventh Edition 


Although this Seventh Edition no longer bears their byline, Ken Thompson and Dennis Ritchie remain 
the fathers and preceptors of the UNIX time-sharing system. Many of the improvements here described 
bear their mark. Among many, many other people who have contributed to the further flowering of 
UNIX, we wish especially to acknowledge the contributions of A. V. Aho, S. R. Bourne, L. L. Cherry, G. 
L. Chesson, S. I. Feldman, C. B. Haley, R. C. Haight, S. C. Johnson, M. E. Lesk, T. L. Lyon, L. E. 
McMahon, R. Morris, R. Muha, D. A. Nowitz, L. Wehr, and P. J. Weinberger. We appreciate also the 
effective advice and criticism of T. A. Dolotta, A. G. Fraser, J. F. Maranzano, and J. R. Mashey, and we 
remember the important work of the Jate Joseph F. Ossanna. 


B. W. Kernighan 
M. D. Mellroy 


TUNIX is a Trademark of Beil Laboratories. 
“VAX and PDP are Trademarks of Digital Equipment Corporation. 


INTRODUCTION TO VOLUME 1 


This volume gives descriptions of the publicly available features of the UNIX/32Vt system, as 
extended to provide a virtual memory environment and other enhancements at U. C. Berkeley. 
It does not attempt to provide perspective or tutorial information upon the UNIX operating sys- 
tem, its facilities, or its implementation. Various documents on those topics are contained in 
Volume 2. In particular, for an overview see ‘The UNIX Time-Sharing System’ by Ritchie and 
Thompson; for a tutorial see ‘UNIX for Beginners’ by Kernighan, and for an guide to the new 


features of this virtual version, see ‘Getting started with Berkeley Software for UNIX on the 
VAX’ in volume 2c. 


Within the area it surveys, this volume attempts to be timely, complete and concise. Where 
the latter two objectives conflict, the obvious is often left unsaid in favor of brevity. It is 
intended that each program be described as it is, not as it should be. Inevitably, this means 
that various sections will soon be out of date. 


The volume is divided into eight sections: 


Commands 

System calls 

Subroutinés 

Special files 

File formats and conventions 

Games 

Macro packages and language conventions 
Maintenance commands and procedures 
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Commands are programs intended to be invoked directly by the user, in contradistinction to 
subroutines, which are intended to be called by the user’s programs. Commands generally 
reside in directory /bin (for binary programs). Some programs also reside in /usr/bin, or in 
/usr/ucb, to save space in /bin. These directories are searched automatically by the command 
interpreters. 


System calls are entries into the UNIX supervisor. The system call interface is identical to a C 
language procedure call; the equivalent C procedures are described in Section 2. 


An assortment of subroutines is available; they are described in section 3. The primary 
libraries in which they are kept are described in intro(3). The functions are described in terms 
of C, but most will work with Fortran as weil. 


The special files section 4 discusses the characteristics of each system ‘file’ that actually refers 
to an I/O device. The names in this section refer to the DEC device names for the hardware, 
instead of the names of the special files themselves. 


The file formats and conventions section 5 documents the structure of particular kinds of files; 
for example, the form of the output of the loader and assembler is given. Excluded are files 
used by only one command, for example the assembler’s intermediate files. 


Games have been relegated to section 6 fo keep them from contaminating the more staid infor- 
mation of section 1. 


tUNIX is a Trademark of Bell Laboratories. 
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Section 7 is a miscellaneous collection of information necessary to writing in various specialized 
languages: character codes, macro packages for typesetting, etc. 


The maintenance section 8 discusses commands and procedures not intended for use by the 
ordinary user. The commands and files described here are almost all kept in the directory /etc. 


Each section consists of a number of independent entries of a page or so each. The name of 
the entry is in the upper corners of its pages, together with the section number, and sometimes 
a letter characteristic of a subcategory, e.g. graphics is 1G, and the math library is 3M. Entries 
within each section are alphabetized. The page numbers of each entry start at 1; it is infeasible 
to number consecutively the pages of a document like this that is republished in many variant 
forms. 


All entries are based on a common format, not all of whose subsections will always appear. 


The mame subsection lists the exact names of the commands and subroutines covered 
under the entry and gives a very short description of their purpose. 


The synopsis summarizes the use of the program being described. A few conventions are 
used, particularly in the Commands subsection: 


Boldface words are considered literals, and are typed just as they appear. 


Square brackets [ ] around an argument indicate that the argument is optional. 
When an argument is given as ‘name’, it always refers to a file name. 


Ellipses ‘...’ are used to show that the previous argument-prototype may be 
repeated. 

A final convention is used by the commands themselves. An argument beginning 
with a minus sign ‘—’ is often taken to mean some sort of option-specifying argu- 


ment even if it appears in a position where a file name could appear. Therefore, it is 


unwise to have files whose names begin with ‘—’. 
The description subsection discusses in detail the subject at hand. 
The files subsection gives the names of files which are built into the program. 
A see also subsection gives pointers to related information. 


A diagnostics subsection discusses the diagnostic indications which may be produced. 
Messages which are intended to be self-explanatory are not listed. 


The bugs subsection gives known bugs and sometimes deficiencies. Occasionaily also the 
suggested fix is described. 


In section 2 an assembler subsection carries the PDP-11 assembly-language system inter- 
face. 


At the beginning of the volume is a table of contents; organized by section and alphabetically 
within each section. There is also a permuted index derived from the table of contents. Within 
each index entry, the title of the writeup to which it refers is followed by the appropriate sec- 
tion number in parentheses. This fact is important because there is considerable name duplica- 
tion among the sections, arising principally from commands which exist only to exercise a par- 
ticular system call. | 7 


HOW TO GET STARTED 


This section sketches the basic information you need to get started on UNIX how to log in and 
log out, how to communicate through your terminal, and how to run a program. See ‘UNIX for 
Beginners’ in Volume 2 for a more complete introduction to the system. 


Logging in. You must call UNIX from an appropriate terminal. Most any ASCII terminal capa- 
ble of full duplex operation and generating the entire character set can be used. You must also 
have a valid user name, which may be obtained, together with necessary telephone numbers, 
from the system administration. After a data connection is established, the login procedure 
depends on what kind of terminal you are using. 
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300-baud terminals: Such terminals include the GE Terminet 300, and most display terminals 
run with popular modems. These terminals generally have a speed switch which should be set 
at ‘300’ (or ‘30’ for 30 characters per second) and a half/full duplex switch which should be set 
at full-duplex. (This switch will often have to be changed since many other systems require 
half-duplex). When a connection is established, the system types ‘login:’; you type your user 
name, followed by the ‘return’ key. If you have a password, the system asks for it and turns 
off the printer on the terminal so the password will not appear. After you have logged in, the 
‘return’, ‘new line’, or ‘linefeed’ keys will give exactly the same results. 


1200- and 150-baud terminals: If there is a half/full duplex switch, set it at full-duplex. When 
you have established a data connection, the system types out a few garbage characters (the 
‘login:’ message at the wrong speed). Depress the ‘break’ (or ‘interrupt’) key; this is a speed- 
independent signal to UNIX that a different speed terminal is in use. The system then will type 
‘login:,’ this time at another speed. Continue depressing the break key until ‘login:’ appears in 
clear, then respond with your user name. From the TTY 37 terminal, and any other which has 
the ‘newline’ function (combined carriage return and linefeed), terminate each line you type 
with the ‘new line’ key, otherwise use the ‘return’ Key. | 


Hard-wired terminals. Hard-wired terminals usually begin at the right speed, up to 9600 baud; 
otherwise the preceding instructions apply. 


For all these terminals, it is important that you type your name in lower-case if possible; if you 
type upper-case letters, UNIX will assume that your terminal cannot generate lower-case letters 
and will translate all subsequent upper-case letters to lower case. 


The evidence that you have successfully logged in is that a shell program will type a prompt (‘S° 
or ‘%’) to you. (The shells are described below under ‘How to run a program.’) 


For more information, consult tser(1), and stty(1), which tell how to adjust terminal behavior, 
getty(8), which discusses the login sequence in more detail, and ¢ty(4), which discusses termi- 
nal I/O. | 


Logging out. There are three ways to log out: 


By typing an end-of-file indication (EOT character, control-d) to the Shell. The Sheil will 
terminate and the ‘login: ’ message will appear again. 


You can log in directly as another user by giving a /ogin(1) command. 


If worse comes to worse, you can simply hang up the phone; but beware — some 
machines may lack the necessary hardware to detect that the phone has been hung up. 
Ask your system administrator if this is a problem on your machine. 


How to communicate through your terminal. When you type characters, a gnome deep in the sys- 
tem gathers your characters and saves them in a secret place. The characters will not be given 
to a program until you type a return (or newline), as described above in Logging in. 


UNIX terminal I/O is full-duplex. It has full read-ahead, which means that you can type at any 
time, even while a program is typing at you. Of course, if you type during output, the printed 
output will have the input characters interspersed. However, whatever you type will be saved 
up and interpreted in correct sequence. There is a limit to the amount of read-ahead, but it is 
generous and not likely to be exceeded unless the system is in trouble. When the read-ahead 
limit is exceeded, the system throws away all the saved characters (or beeps, if your prompt was 
a %). 


The character ‘@’ in typed input kills all the preceding characters in the line, so typing mistakes 
can be repaired on a single line. Also, the character ‘#’ erases the last character typed. (Most 
users prefer to use a backspace rather than ‘#’, and many prefer control-U instead of *@’, 
tset(1) or stty(1) can be used to arrange this.) Successive uses of ‘#’ erase characters back to, 
but not beyond, the beginning of the line. ‘@’ and ‘#’ can be transmitted to a program by 
preceding them with ‘\’. (So, to erase ‘\’, you need two ‘#’s). 


The ‘break’ or ‘interrupt’ key causes an interrupt signal, as does the ascii ‘delete’ (or ‘rubout’) 
character, which is not passed to programs. This signal generally causes whatever program you 
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are running to terminate. It is typically used to stop a long printout that you don’t want. How- 
ever, programs can arrange either to tgnore this signal altogether, or to be notified when it hap- 
pens (instead of being terminated). The editor, for example, catches interrupts and stops what 
it is doing, instead of terminating, so that an interrupt can be used to halt an editor printout 
without losing the file being edited. Many users change this interrupt character to be “C 
(control-C) using stty(1). 


It is also possible to suspend output temporarily using “S (control-s) and later resume output 
with “Q. In a newer terminal driver, it is possible to cause output to be thrown away without 
interrupting the program by typing “O; see newtty(4). 


The quit signal is generated by typing the aScil FS character. (FS appears many places on 
different terminals, most commonly as control-\ or control-|.) It not only causes a running pro- 
gram to terminate but also generates a file with the core image of the terminated process. Quit 
is useful for debugging. 


Besides adapting to the speed of the terminal, UNIX tries to be intelligent about whether you 
have a terminal with the newline function or whether it must be simulated with carriage-return 
and line-feed. In the latter case, all input carriage returns are turned to newline characters (the 
standard line delimiter) and both a carriage return and a line feed are echoed to the terminal. 
If you get into the wrong mode, the reset(1) command will rescue you. 


Tab characters are used freely in UNIX source programs. If your terminal does not have the tab 
function, you can arrange to have them turned into spaces during output, and echoed as spaces 
during input. The system assumes that tabs are set every eight columns. Again, the ¢ser(1) or 
stty(1) command will set or reset this mode. T7set(1) can be used to set the tab stops automati- 
cally when necessary. 


How to run a program; the shells. When you have successfully logged in, a program called a 
Shell is listening to your terminal. The shell reads typed-in lines, splits them up into a com- 
mand name and arguments, and executes the command. A command is simply an executable 
program. The Shell looks in several system directories to find the command. You can also 
place commands in your own directory and have the shell find them there. There is nothing 
special about system-provided commands except that they are kept in a directory where the 
shell can find them. = 


The command name is always the first word on an input line; it and its arguments are separated 
from one another by spaces. 


When a program terminates, the shell will ordinarily regain control and type a prompt at you to 
indicate that it is ready for another command. 


The shells have many other capabilities, which are described in detail in sections sh(1) and 
csh(1). If the shell prompts you with ‘$’, then it is an instance of sh(1) the standard Bell-labs 
provided shell. If it prompts with ‘%’ then it is an instance of csh(1) a shell written at Berke- 
ley. The shells are different for all but the most simple terminal usage. Most users at Berkeley 
choose csh(1) because of the Aistory mechanism and the alias feature, which greatly enhance its 
power when used interactively. Cs also supports the job-control facilities new to this release of 
the system. See newcsh(1) or the Csh introduction in volume 2C for details. 


You can change from one shell to the other by using the chsh(1) command, which takes effect 
at your next login. 


The current directory. UNIX has a file system arranged in a hierarchy of directories. When the 
system administrator gave you a user name, he also created a directory for you (ordinarily with 
the same name as your user name). When you log in, any file name you type is by default in 
this directory. Since you are the owner of this directory, you have full permission to read, 
write, alter, or destroy its contents. Permissions to have your will with other directories and 
files will have been granted or denied to you by their owners. As a matter of observed fact, 
few UNIX users protect their files from perusal by other users. 
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i change the current directory (but not the set of permissions you were endowed with at 
login) use cd(1). 


Path names. To refer to files not in the current directory, you must use a path name. Full 
path names begin with ‘/’, the name of the root directory of the whole file system. After the 
slash comes the name of each directory containing the next sub-directory (followed by a ‘/’) 
until finally the file name is reached. For example, /usr/lem/filex refers to the file filex in the 
directory /em; lem is itself a subdirectory of usr; usr springs directly from the root directory. 


If your current directory has subdirectories, the path names of files therein begin with ne name 
of the subdirectory with no prefixed ‘/’. 


A path name may be used anywhere a file name is required. 


Important commands which modify the contents of files are cp(1), mv(1), and rm(1), which 
respectively copy, move (i.e. rename) and remove files. To find out the status of files or direc- 


tories, use /s(1). See mkdir(1) for making directories and rmdir (in rm(1)) for destroying 
them. 


For a fuller discussion of the file system, see ‘The UNIX Time-Sharing System,’ by Ken Thomp- 
son and Dennis Ritchie. It may also be useful to glance through section 2 of this manual, 
which discusses system calls, even if you don’t intend to deal with the system at that level. 


Writing a program. To enter the text of a source program into a UNIX file, use the editor ex(1) 
or its display editing alias wi(1). (The old standard editor ed(1) is also available.) The principal 
languages in UNIX are provided by the C compiler cc(1), the Fortran compiler /77(1), the Pas- 
cal compiler pc(1), and interpreter pi(1) and px(1), the Lisp system /isp(1), and the APL sys- 
tem ap/(1): After the program text has been entered through the editor and written on a file, 
you can give the file to the appropriate language processor as an argument. The output of the 
language processor will be left on a file in the current directory named ‘a.out’. (If the output is 
precious, use mv to move it to a less exposed name soon.) 


When you have finally gone through this entire process without provoking any diagnostics, the 
resulting program can be run by giving its name to the shell in response to the shell (‘3° or ‘%’) 
prompt. 


Your programs can receive arguments from the command line just as system programs do, see 
exec(2). 


Text processing. Almost all text is entered through the editor ex(1) (often entered via vwi(1)). 
The commands most often used to write text on a terminal are: cat, pr, more and nroff, all in 
section 1. 


The cat command simply dumps ASCII text on the terminal, with no processing at all. The pr 
command paginates the text, supplies headings, and has a facility for multi-column output. 
Nroff is an elaborate text formatting program. Used naked, it requires careful forethought, but 
for ordinary documents it has been tamed; see me(7) and ms(7). 


Troff prepares documents for a Graphics Systems phototypesetter or a Versatec Plotter; it ts 
very similar to nroff, and often works from exactly the same source text. It was used to pro- 
duce this manual. 


Script(1) lets you keep a record of your session in a file, which can then be printed, mailed, etc. 
It provides the advantages of a hard-copy terminal even when using a display terminal. 


More(1) is useful for preventing the output of a command from zipping off the top of your 
screen. It is also well suited to perusing files. 


Status inquiries. Various commands exist to provide you with useful information. w(1) prints 
a list of users presently logged in, and what they are doing. date(1) prints the current time and 


date. /s(1) will list the files in your directory or give summary information about particular 
files. 


Surprises. Certain commands provide inter-user communication. Even if you do not plan to 
use them, it would be well to learn something about them, because someone else may aim 


them at you. 


To communicate with another user currently logged in, write(1) is used: mai/(1) will leave a 
message whose presence will be announced to another user when he next logs in. The write- 
ups in the manual also suggest how to respond to the two commands if you are a target. 


If you use csh(1) the key “Z (control-Z) will cause jobs to ‘‘stop’’. If this happens before you 
learn about it, you can simply continue by saying ‘‘fg’’ (for foreground) to bring the job back. 


When you log in, a message-of-the-day may greet you before the first prompt. 


CONVERTING FROM THE 6TH EDITION 


There follows a catalogue of significant, mostly incompatible, changes that will affect old users 
converting from the sixth edition on a PDP-1i1. No attempt is made to list all new facilities, or . 


even all minor, but easily spotted changes, just the bare essentials without which it will be ~~ 


almost impossible to do anything. 


Addressing files. Byte addresses in files are now long (32-bit) integers. Accordingly seek has 
been replaced by /seek(2). Every program that contains a seek must be modified. Svat and 
fstat(2) have been affected similarly, since file lengths are now 32- rather than 24-bit quantities. 


Assembly language. This language is dead. Necromancy will be severely punnished. 
Stty and gtty. These systern calls have been extensively altered, see joct/(2) and tty(4). 


C language, lint. The syntax for initialization requires an equal sign = before an initializer, 
and brackets { } around compound initial values; arrays and structures are now initialized 
honestly. Assignment operators such as =~+ and =— are now written in the reverse order: 
+=, —-=2, This removes the possibility of ambiguity in constructs such as x=—2, y™*p, and 
a= /*b. You will also certainly want to learn about 


long integers 

type definitions 

casts (for type conversion) 

unions (for more honest storage sharing) 

#include <filename> (which searches in standard places) 


The program /int(1) checks for obsolete syntax and does strong type checking of C programs, 
singly or in groups that are expected to be loaded together. It is indispensable for conversion 
work. 


Fortran. The old /¢ is replaced by 77, a true compiler for Fortran 77, compatible with C. 
There are substantial changes in the language; see ‘A Portable Fortran 77 Compiler’ in Volume 
Zz; | 


Stream editor. The program sed(1) is adapted to massive, repetitive editing jobs of the sort 
encountered in converting to the new system. It is well worth learning. 


Standard I/O. The old fopen, getc, putc complex and the old —/p package are both dead, and 
even getchar has changed. All have been replaced by the clean, highly efficient, stdio(3) pack- 
age. The first things to know are that getchar(3) returns the integer EOF (—1) (which is not a 
possible byte value) on end of file, that $18-byte buffers are out, and that there is a defined 
FILE data type. 


Make. The program make(1) handles the recompilation and loading of software in an orderly 
way from a ‘makefile’ recipe given for each piece of software. It remakes only as much as the 
modification dates of the input files show is necessary. The makefiles will guide you in building 
your new system. 


Shell, chdir. F. L. Bauer once said Algol 68 is the Everest that must be climbed bye every com- 
puter scientist because it is there. So it is with the shell for UNIX users. Everything beyond 
simple command invocation from a terminal is different. Even cAdir is now spelled ca. If you 
wish to use sh (as opposed to cs) then you will want to study sh(1) long and hard. 
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C shell. Csh(1), developed at Berkeley, has features comparible to sh. It includes a history 
mechanism that saves you from retyping all or part of previous commands, as well as an 
efficient aliasing (macro) mechanism. The job control facilities of the system, which make the 
system much more pleasant to use, are currently available only with csh. See newcsh(1) for a 
description. These features make cs/ pleasant to use interactively. Csh programs have a syntax 
reminiscent of C, while sh command programs have a syntax reminiscent of ALGOL-68. 


Debugging. Sdb(\) is a far more capable replacement for the debugger cdb, and debugs C and 
Fortran at the source level. For machine language debugging, adb replaces db. The first-time 
user should be especially careful about distinguishing / and ? in adb commands, and watching 
to make sure that the x whose value he asked for is the real x, and not just some absolute loca- 
tion equal to the stack offset of some automatic x. You can always use the ‘true’ name, _x, to 
pin down a C external variable. 


Dsw. This little-known, but indispensable facility has been taken over by rm —ri. 


Boot procedures. Needless to say, these are all different. See section 8 of this volume, and the 
other documentation you should have received with your tape. 


CONVERTING FROM THE DECEMBER, 1979 BERKELEY DISTRIBUTION 


There have been a number of significant changes and improvements in the system. This 
list just gives the bare essentials: — 


C language changes. The C compiler now accepts and checks essentially arbitrary length 
identifiers and preprocessor names. There is a new type available in type casts: void which 
signifies that a value is to be ignored. It is useful in keeping lint happy about values which are 
not used (especially values returned from procedures). Finally, the language has been changed 
so that field names need not be unique to structures; on the other hand, the compiler insists 
that you be more honest about types involved in pointer constructs or it will warn you. 


Object file format. The object file format has been changed to include a string table, so that 
language compilers may have names longer than 8 characters in their resulting a.out files. Old 
.o files must be recreated. A.ouwt files will still run on both this and the December 1979 version 
of the system; only the symbol tables are incompatible. 


Archive format and table of contents. The archive format has been changed to one which ts port- 
able between the VAX and other machines (e.g. the PDP-11). Old VAX archives should be 
converted with arcv(8): loader archives should just be recreated since the object files are also 
obsolete. Loader archives should have table-of-contents added by ranlib(1). if they dont the 
loader will gripe when they are used. See also o/d(8). 


New tty driver, job control facilities and csh. Hand in hand are new job control facilities, a new 
tty driver and a new version of the C shell which supports and uses all of this. See newrry(4) 
and newcsh(1) for a quick introduction. You should use o/dcsh until you learn about the new 
facilities. 


Pascal compiler. There is a true Pascal compiler, pc(1) which allows separate compilation as 
well as mixing in of FORTRAN and C code. 


Error analyzer. There is an error analyzer program error(1), which takes a set of error message 
and merges them back into the source files at the point of error. It can be used interactively to 
avoid inserting errors which are uninteresting. This program eliminates once and for all making 
lists of errors om small scraps of paper. , 


Mail forwarding. The system now provides mail forwarding and distribution facilities. Group 
and aliases are defined in the file /usr/lib/aliases see aliases($). If you change this file you wall 
have to rerun newaliases(1). For any particular system a table in the source of the delivermail 
postman program may have to be changed so that it knows about the gateways on the local 
machine. 


System bootstrap procedures. These are totally changed; the system performs automatic reboots 
and preens the disks automatically at reboot. You should reread the appropriate pages in 
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section 8 if you deal with system reboots. 
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vread Gide Si abt a ie ee Ser cbt Jee Ge ES GY cen Ctra 6 or. Be ee ae es Be Ge ee we cere ee CSA Wit 
vswapon oe ew ew ew ew ew ww ew ww wl e)6Oadd a Swap device for interleaved paging/swapping 
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MOC ca Ke eae Se ee ee ee ee ee eS ee Ee CONVETC ASCII 10 aunibers 
crypt siete det ge See Settee le, Oo et SRS Ss “ate oe SG: eR es. & Se ee 6-8. ee” DE opener pen 
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getfsent . 2... ew ee ee ee we ew ew ew ww ww we) get file systern descriptor file entry 
ROtCrent 2.6 Seow ae we ee SG eee ow 4 eS ee we ea oe SEL Croup Rlée-entry 
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jobs bf ce a SR Oe we Se RES Ew RS Oe Se. SUMMATy Of Job control facilines 
I3tol oe ew te ew wt ww ew ew we wh ew e)~€6CONVEFt between 3-byte integers and long integers 
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4, Special Files 


MtLO. <6 ce wave -% 


autoconf : : = . 
bk @ @ ee e @ & ® 
cons 


ct pam! Sie See at ae 
2 9 ne ee ee 


drum die at at oe ; Bote es 
fl See ee a 


DR | oe ko 0.8, & ee 


hp ek. ee A we ee 
Rte Gr aa hee cas ne ee 


mem ger Hee he Ge, ee tes Bos 
Mt: Ske ba a ee A 
HEWUNY <.40% 8,-4.6 & 
null as sr ies al oe. aon ee Be 


{s Me a Re ee, We 
tty P ae a2 6) eee e 
Wo: oh as oe Se A ee Be oe ee 
WA. get yl @ ag 


§. File Formats 


a.out ge ode Marois eo tee SE 
BCC te Sse eno ee es 
aliases a ee ee 
Qe> vie Se oe: UE ce: Sw 
core ots: eee Medes ae Aes 
dir it Oh fe. 28, ae he os 
GUMO 405). 4 whee ot Boe Sa Ss 
environ ee ace ee, Ot Ga ae Ls 
NiSyS: «8 «@ 2 oe 456-0-% 
fstab Mo Be ee a ee 
group A bey. ia Wh, tae te a as ee SE 
Mpxi1o ds Sb, Wis Gs. Ge et 
mitab bi, Me te: SE. es abe et Ge) i er fe oe 
passwd Ge ok. = ae, Gao Zee Rast a) So BS 
plot Bas PG tgs ae ee Boe Se ee SB 
SUA oe AE: tps a. Se a we te SS. 
USPICID. er Be Sa we ee ey 


tp ek, ke Ge to Sex Be te SE ns Se ae 


tlys ® ® 9 e 2 @ © ® @ e ® 


ttytype a ee ee eee ee 


types cd @ L) @ & 6 @ e 8 6 8 ® @ ® 
utmp ® e e ® @ ® S ® ® SB S @ @ 6 eo 


uuencode a lah ae ae He 2a SE vas aes ee ve 
vfont @ ® cd J @ eo @ @ . 2s s @ @ S 
wtmp a @ @ e © @ 2 oo @ e e @ 
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| introduction to special files 
diagnostics from autoconfiguartion code 


line discipline for machine-machine communication 


o XX e- 


VAX-11 console interface 

- ... . phototypesetter interface 

: DH- 11/DM-11 communications multiplexer 
& 4 paging device 

DZ- ne communications multiplexer 


; . . floppy interface 
" RK6- AV/RK06 a RKO7 moving head disk 
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" RPO6, RM03, RM05, RM80, RPO7 MASSBUS moving-head disk 
TM-03/TE-16,TU-45,TU-77 MASSBUS magtape interface 
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oe awe sine printer 
seco: races for mail notification 
main memory 

" UNIX magtape interface 
summary of the ‘‘new’’ tty driver 
: data sink 
"Raca/ Vidic ACU interface 
TM-11/TE-10 magtape interface 
TS-11 magtape interface 

- 2 « « « ~~ general terminal interface 

. . .  Unibus storage module controller/drives 
Benson- Varian interface 
Versatec interface 
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assembler and link editor.output 
execution accounting Ale 
aliases file for delivermail 
archive (library) file format 
format of memory image file 
format of directories 
incremental dump format 
user environment 
format of Ale system volume 
information about the filesystems 
. . group file | 
ee ee ae - » . multiplexed i/o 
es ounned file system table 
password file 
graphics interface 
es symbol table types 
~e « » « « terminal capability data base 
ch 32. i ae ee ee SC hiiae tape formas 
terminal initialization data 
data base of terminal types by port 
primitive system data types 
: oo login recorcs 
; foes o an encoded uuencode file 
font formats for the Benson- Varian or Versatec 
user login history 
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6. Games 


aardvark be: Gai ae Oe. Gee Tes we oe wt ee tee a, ww a es sw «Oat ner exploration game 


adventure ele ae a ee eS ee a A a a te ee OX BIORAlIOn game 
aliens 6. ww ww ee we ee tw ww we we we we) UE align invaders attack the earth 
arithmetic ic cae ee Oe a ee Ae Swe a me ee we Sa (DPOVIdediillin number facts 


DAGKOAMIAION: ai hn tee Wend, Sh Ai Hee: BO WO ee eh Ee Se ee Se ch ee RO ame 
banner ie gs Wa, Se AS OB Se Se A ee Sa Se eS ae SS. «OPNINE Jaree- Danner Onprinter 
bed Soap A ae lee She SO a a ke we wy ee ee a ee Sa See we. MOON VER-1Osantigue media 
boggle D6 G0 NE BE RS RE SE Sa a ee eee we a eG |, TDlAY TNS BaMe OF boesie 
chase gs SG fat Be ek ee tas eS ae He es Se Se Ge ee Se AY 10 esca0e 10 Killer rooots 
chess Si. Seb. Hh he sae age ee, As eth a OR See. BS lec dee “Ayn Se ae ee Mae nee a RO BatTiCnOr cess 
ching es Be A es we Ew Se a ee te DOOk of changes and-other cookies 
RTLOOASE ge 5) ok: ae “hy a> Se ee ae St ee ee ee a «~“Nard pame Cribbage 
doctor Sai Dae ap BE. Hin Sa, eS GR a eS. as ew es SO FACT WIth a psychoanalyst 
fish Be et Me He Ot wa ED. A eto ee MA cts Se eS ee ce Se Oe i a we, Roe a LAV Ge Fish 
fortune o 8 ee ee et ew we ww ew hw he hw heh e™~)~«6Upinnt a random, hopefully interesting, adage 


hangman oe ee ete ww ww ew ee th heheh e)6UCOmputer Version of the game hangman 
mille eB be Bite He Bie eb ake Se BL ao an wat > GG ee Bae: & eg ad a Se . “Dla Mille Bournes 
monop he br Gh hs Ee Gt we SS, ae oe eh a es HE a, ee aS we OO DOly pame 
number Cae ee we AM ARS SS AE ww BS CONVEFt Arabic numerals to English 


quiz sides Wee ae TS Sar ae Tae- id ns a Ge at GE Ee WS ok wee a ES OR Es es ee de. ” TES CVOUT KnOWwiecee 
rain bo. te ti A GE Ge eh i as Ee Wh es & ee. oe, SARI ated Taindrops display 
rogue bg 4 Re wee OG AGS Sa aR we & Exploring The Dungeons of Doom 
SHAKE: 2h a: ho Se me he oes eee Se ew a oe, ew Sw we A ee Be se. «SS Play chase game 
trek oo: 3G ee we ae ae ee SS ee a OS Se See a ee we SSeS Ke @ame 


worm bse Bb GL Wel ae Bee ae Re ewe we ow ee CORY Te erowing: worn came 
worms ge cb Ve Wie. el HO OR ae Ge SON eS wwe. “@RIMmate Worms ona display terminal 
wump ot ww tw we te te wt ww tt wt ew wh eh whl wh el h)6 «6the game Of hunt-the-wumpus 


zork i c's hn es ce RP ae Ge state he Heke om, ta SW , SS os ee ew. TRE Pame OF dungeon 


2 Miscellaneous 


ASC Gk. Snld Wi Rw ot ee eee & SS Se ee ee Se MN OF ASCII character set 
eqnchar oe ee we tw ew tw ww ww oe ew we ew ee e)©6SpOCial character definitions for eqn 
greek . 1. 1 1 ww we tw ew te ww ew wh ww eh e~)=6graphics for extended TTY-37 type-box 
BIOE  d tee dae we ws a ee a a ce ew SS i wl ae eS Sw, eS SCE hierarchy 
man eo Ge ah cee ee BN ee ewe Re ra Bee Ae a eS owe: ENB OTOS FO ty eset manua! 
me Se are ee Bee a eS Bie he ee PSs > ACTOS tor formatting. papers 
MS ... 4 6 ee ee ee ew ee pw ee we ee ee e~)©6Macros for formatting manuscripts 
CCI. a a ee A Se Sw ee a we ae OCONVENUCNal names 


8. System Maintenance 


ac doe tee ts ce ee GP sds ahs Bs SE ee ob okt Ba He A He ee a a eg: ~ORINAECOUnTI AZ 
adduser 6a we Bw ae aw ae a Sa Se eee Se OPPOCedure tor-adding new users 
analyze oe te ew ew wt ww ww ew ew wt tw eh )©)6UVEFtual: UNTX postmortem crash analyzer 
arcy 6s 8 a! ah Re, Se Mae Se SW ee a ee ee es ae we SCORIVERT ALCHIVES (6 NEW TOrmat 
QR eo Roe Se ce ke es Be a a a Oe Eee ES PCIE and copier or lesoy 
badl44 w 5 ww ww we we we tw et we )=6f@ad/ write dec standard 144 bad sector information 
DaGSeCl, 44 eo bh ea A we OG we ee A ee. “CPOate- Rles (0-contain bad ‘sectors 
catman ered Te Be awe Sp & ood, ay Wi al a ds ee “RTS Ce Cal Biles: for tne manual 
CNOWD 6. -m: Se ae Se we cere: A ah ee Ge: Gwe BG BL Bod: Sa | & CRANE OWNEr Or 2rouD 
clri wes ht WS tal dee SR So, Jan ee Vet oR: Ob He tag Ge eee AE ee Se oe as ey dk we ek ee te. CIOS ienode 
config si dg sos Ta Re 2g SLES wy Rw ea, OG a hte a UBU Gystem: conheuration files 
crash se ee ee we ew ww ww ww he hhh eh©)6UWat happens when the system crashes 
GEO ve. ie. at pe Bet ad. es es he ee ee Ee a ke Bt, wa wh a et See ee - ce . UCHR daemon 
dcheck oe ee ew ew ww we we wt ww wt ee”) Bile System directory consistency check 
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delivermail aoe OR Ge coo ae BOR a Gees es ae te a Se we tw “OHV Oma (O-arbittary peccie 


dmesg ......+64...2..22.... #£cCOllect system diagnostic messages to form error log 
dump ie RR ok RE ee eS ee SO de Seow Re SOR ee Oe ee IEE! Alevsystem-dumo 


dumpdir se ee ww te ew ww ww we we eh wl )~)©6print the names of files on a dump tape 
[OrmMat.. 2 6. da 6 a 


SoS, 8. dah as Bo a Be oe ee eo a A Ae ~OWO Orimiat disks 
fsck ee ee ke we ww ww ew ew wl ~~ file syStem consistency check and interactive repair 
getty bo Ggtew Nee: adn he ee es Be A Be at es Re oe a a eee em PSR ETErie al mode 


halt ee ae ae ee ee 
icheck Nea ee Soy ee 
6) | oe a ene 
makekey i er SS Ge ah era 
PKTS ce, ksh ee ne ve ae HS 


ci Tae ven ee tig, hs ae was Dee a a SR ee es ee ee we «SSO The orocessor 
oe ww ew ww ww ew ww ew tw he © file system storage consistency check 
. process control initialization 
BO Gos Be Be. ee he ee ee A aa oe Se, “BD TATE-Cicry ction: Key: 
ede gh Bbw ae ah Bs a on we Se we  COMSIFUCL A Tle system 


mklost +found bc aH a De. Bt Ok. Ge we Rw  . PNK E A Ost found directory for fsck 
mknod sour ic, eS. ndy wey es Gey Rc th Be Wes we we Se De Ee ew DUI spec a tie 
mount SH BOR SS SOR OR Ow AR ESE SER THOUND aNd dismount fle system: 
ncheck Sh A an ae we a A AS ee SS we OMS ME TALS Games from.at-aumobers 


old b= Uhh le ha de ws Ge we ee, ad od oe ee a ee HE Ee ee. “eC LORY Or Cid Dreerams 
Sigh 4 a es ee ee Ba eS Oe Ea EKO EAS SES a PNG Sysremtacs 
quot Bik Kobe Be Re a Re BS es Ra: “SS a ce, “SUMINATIZe Ale system: ownersnio 
» » « « command script for auto-reboot and daemons 
oe ee ew ww ww ew wh eh e)6UUNITX 6 bootstrapping procedures 
renice we ew we ww ew ew ew tw we ew el fl he) 6 alter priority of running process by changing nice 


re @ @ Vd @ ® ea s @ @ @ 8 @ ® @ 6 


reboot @ @ ® 8 @ @ ® & ® @ i) 


restor Bs ek Bh eae Se es ee eG we Oe owe we. CPO Meal Rlesyste. restore 
SA. atic we eS Bee SE Se CRS aw ESS ES EE SES BSCR ACCOUNT 
savecore wee et wt tw tlt tt tw et wh e!)~«6SAVE ACOre dump of the operating system 
shutdown WS ee GR we Re we ewe Sw SS «Close: down the system at a given time 
sticky See whe eee ES we ERE ME we we  OXOCUTADIS Mlés Wilh persistent text 
swapon we we ew ew ew ew ww ew ew eh e)@)6Specify additional device for paging and swapping 


SVHC- a ve ae SR ee es a we SE Oe See eo or ee ate the super bidcK 
update ao So Be. Bg RAS * ee eee PeTIOdIeally update the super block 
ViIPW sk. be weow ee A Se wl ee a ew Se we Sw Soe ee CIE The Password Nie with: vi 
vpac ww wk we ww ww we ew ew ww ~~) 6Oprint raster printer/ploter accounting information 
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PERML 


bad144: read/write dec standard 

I3tol, ltol3: convert between 

diff3: 

tk: paginator for the Tektronix 

rman: translate version 

(rman: translate version 6 manual macros to version 


vuimes: get information 

fstab: static information 

learn: computer aided instruction 

vfontinfo: inspect and print out information 


abs: integer 
fabs, floor, ceil: 


access: determine 

ac: login 

Sa, accton: system 

acct: execution 

vpac: print raster printer/ploter 
acct: turn 


Sa, 
sin, COS, lan, asin, 

rv: Racal/ Vadic 

fortune: print a random, hopefully interesting, 


vswapon.: 
adduser: procedure for 
swapon: specify 


vadvise: give 

yes: be repetitively 
basename: strip flename 
learn: computer 

plot: openpl et 


unalias: remove 


which: locate a program file including 
newaliases: rebuild the data base for the mail 
aliases: 

aliens: The 


valloc: 

brk, sbrk, break: change core 
malloc, free, realloc, calloc: main memory 
vailoc: aligned memory 
eyacc: modified yacc 

limit: 

renice: 

else: 

lex: generator of lexical 
error: 

style: 


analyze: Virtual UNIX postmortem crash 
worms: 

rain: 

bed: convert to 


apl: an 


ITED INDEX 


@: arithmetic on shell variables. 

144 bad sector information. 

3-byte integers and long integers. 
3-way differential file as 
4014. 

6 manual macros 6 version ce macros. 
7 macros. ; 

aardvark: yet aAGine ‘exploration sane 
abort: generate a fault. 

about resource utilization. 

about the filesystems. 

about UNIX. ee 

about unix fonts. Se Te ee 

abs: integer absolute value. rar 
absolute value. See ‘ 
absolute value, floor, ceiling fuvicuons. 
ac: login accounting. : 

access: determine accessibil ity af file 
accessibility of file 

accounting. 

accounting. 

accounting file 

accounting information. 

accounting on or off. ‘ 

acct: execution accounting file 

acct: turn accounting on or off. 
accton: system accounting. 

acos, atan, alan2: trigonometric functions: 
ACU interface. 

adage. ee: oy 

adb: debugger. 


add a swap device for ate leave paging/ swapping 


adding new users. ‘ 
additional device for paging and sue 
adduser: procedure for adding new users. 
adventure: an exploration game. 
advice tO paging system. 
affirmative. 
affixes. ' 
va instruction abou UNIX. 
: graphics interface. 

ee schedule signal after somcihed anne: 

alias: Shell macros. . 
aliases. =e a 

aliases: aliases Ail le for ‘de! vernal: 

aliases and paths (csAonly). 
aliases file. 8. og: tan, Ge a 
aliases file for delivermail. 
alien invaders attack the earth. . 
iens: The alien invaders attack the earth 
igned memory allocator. 
location. . 
locator. 
allocator. 

allowing much astouedie error eecavery: 
alter per-process resource limitations. ; 
alter priority of running process by changing nice. 
alternative commands. ..... . + ee. 
analysis programs. .. . , 
analyze and disperse eoHioilent error -pieseques: 
analyze surface characteristics of a document. 


ali 
all 
al 
al 
al 
| 


analyze: Virtual UNIX postmortem crash analyzer. 


analyzer. 

animate worms ona a displ ay cermin 
animated raindrops dispiay. 

antique media. , ; 

a.out: assembler and link ana oatue 

apl: an apl interpreter. 

apl interpreter. , ; 
apropos: locate commands by hayward soko. 
ar: archive and library maintainer. 

ar: archive (library) file format. 
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esh(1) 
bad!44(8) 
I3tol(3) 
diff3 (1) 

tk (1) 
trman(1) 
trman(1) 
aardvark (6) 
abort(3) 
vumes(2v) 
fstab (5) 
learn(1) 
vfontinfo(1) 
abs(3) 
abs(3) 
floor (3M) 
ac (8) 
access(2) 
access (2) 
ac (8) 

ga (8) 
acct(5) 
vpac(8) 
acct (2) 
acct(5) 
acct(2) 

sa (8) 
sin(3M) 

rv (4) 
fortune (6) 
adb(1) 
vswapon(2v) 
adduser(8) 
swapon (8) 
adduser (8) 
adventure (6) 
vadvise (2v) 
yes(]) 
basename(1) 
learn(1) 
plot(3x) 
alarm (2) 
esh(1) 
csh(1) 
aliases (5) 
which (1) 
newaliases(1) 
aliases (5) 
aliens (6) 
aliens (6) 
valloc(3) 
brk (2) 
malloc (3) 
valloc(3) 
evacc(]) 
esh(1) 
renice (8) 
esh(1) 

lex (1) 
error(]) 
style (1) 
analvze (8) 
analvze(8) 
worms (6) 
rain(6) 

bed (6) 
a.out(S) 
apl(1) 
apl(1) 
apropos(1) 
ar(]) 

ar($) 


Permuted Index 


number: convert 
delivermail: deliver rail to 
be: 

tp: manipulate tape 

ar: 

ar: 

tar: tape 

arff, flcopy: 

arcv: convert 

ranlib: convert 


w. who is on and what they 
users: compact list of users who 


glob: filename expand 
shift: manipulate 
varargs: variable 

echo: echo 

echo: echo 

expr: evaluate 

gelarg, iargc: command 
be: arbilrary-precision 


@: 


bill: be notified if mail 
expr: evaluate arguments 


gmtime, asctime, timezone: convert date and time to 
ascii: map of 


atof, atoi, atol: convert 
ctime, localtime, gmtime, 
sin, cos, tan, 

as: 

a.out: 


setbuf: 
shutdown: close down the system 
at: execute commands 


nice, nohup: run a command 
SIN, COS, tan, asin, acos, 
sin, cos, tan, asin, acos, atan, 


atof, 
atof, atoi, 
aliens: The alien invaders 


autoconf: diagnostics from 
rc: command script for 
wait: 


bg: place job in 

wait: wait for 

bad144: read/write dec standard 144 
badsect: create files to contain 
information. 


banner: print large 


termecap: terminal capability data 
newaliases: rebuild the data 

ttytype: data 

fetch, store, delete, firstkey, nextkey: data 
vi: screen oriented (visual) display editor 


bill: 

yes: 

cb: C program 
uptime: show how long system has 
va: 

vfont: font formats for the 

30, jl, jn, yO, yl, yn 


Arabic numerals to English. 

arbitrary people. ... , 
arbitrary-precision arithmetic aamiaee: 
Q@PCHIVE, «ne > Sales iG aS yar a 
archive and library anaiAtainer: oe 
archive (library) file format. 

archiver. Oo ; 

archiver and sooie? for floppy: 

archives to new format. .. 

archives to random libraries. ; 
arcv: convert archives to new format. 
are doing. ; 

are on the system. a 

arff, flcopy: archiver and cone for oppy. 
argument list. i GA a, 3 

argument list. 


argument list. ..... 
arguments. Si EHO ee Bde 
arguments. a ; 
arguments as an expression. 
arguments to Fortran. ar a ie 


arithmetic language. : 

arithmetic on shell wariables: 

arithmetic: provide drill in number eis 
arrives and who it is from. Ss ee Ss 
aS an expression. . . 2. 6. 6. 6 we ew ww 


as: assembler. Se oe ces os HL a WS ee 


ASCII. ctime, localtime, ...... 
ASCII character set. SNS tat, Bass i. en 
ascii: map of ASCII character set. yes 
ASCII to numbers. .......e86. 


asctime, timezone: convert date and time to ASCII. 


asin, acos, atan, atan2: sella functions. 
assembi ief. e cy @ o Py o a ° e ° e e @ 


assembler and link saitoe puipue. fh aes eae Se, 


assert: program verification. ........ 
assign buffering to a stream. ; 

ata given time. 

atalatertime. ...... . 

at: execute commands at a later time. 


at low priority (sAonly). is thee Ate Faatge “gs Hs OS ate te ood 


atan, atan2: trigonometric functions. 

atan2: trigonometric functions. 

atof, atoi, atol: convert ASCII to numbers. 

atoi, atol: convert ASCII to numbers. 

atol: convert ASCII to numbers. 

attack the earth, .... : 
autoconf: diagnostics from autoconfhguartion pode. 
autoconfguartion code. .. <8 
auto-reboot and daemons. 21a bee 


await completion of process. ....... a 


awk: pattern scanning and processing language. 


backgammon: the game. Seay aS Se Ee ee Meat ae 
BaCkeround.. 6.7% s a62G56, a Se ce. See So ae 8 


background processes {o complete. ...... 
bad sector information. .....+4.+.e.«.e.-s. 
bad sectors. .. : 
bad 144: read/write dec stantiard 144 bad sectet 
badsect: create files to contain bad sectors. 
banner on printer. a He. ap Se oe 
banner: print large banner on printer. 


base. ... ot ae a ee 
base for the rail aliases file Bik SS ih et ale ee, 
base of terrninal types by port. gy Hie dos se gs 3 
base Subroutines. dbminit, .... 


based onex. .. Gs ai at et ene ES 
basename: strip Riedanie affixes. re ee ee 
be: arbitrary-precision arithmetic language. ae 
bed: convert to antique media. , 

be notified if mail arrives and who 1 is from. 


be repetitively affirmative. tei sree ey Oe aye et we 
DESUUHEES “feo ac'd sec ee A een Se a ee -eo 
been up. Be Gpeiin te aa de ek ates on Hee teeth odes & 
Benson- Varian interface. Dates “Has Sahar Qe. 1 
Benson-Varian or Versatec. ........ 
bessel functions. . . 2... 0. 1 ee ew ew 
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number (6) 
delivermaii (8) 
be (1) 

tp(1) 

ar(1) 

ar(5) 

tar{1) 
arff(8) 
arcv(8) 
ranlib(]) 
arcv(8) 
will) 
users(]) 
arff(&) 
esh(]) 
esh(]) 
varargs (3) 
csh(1) 
echo(1) 
expr(1) 
getarg (3f) 
be (1) 
esh(1) 
arithmetic(6) 
biff(1) 
expr(1) 
as(1) 

ctime (3) 
ascii (7) 
ascii (7) 
atof(3) 
ctime (3) 
sin(3M) 
as(1) 
a.out(5) 
assert (3x) 
setbuf (3S) 
shutdown (8) 
at(1) 

at(1) 

nice (1) 
sin(3M) 
sin(3M) 
atof(3) 
atof(3) 
atof(3) 
aliens (6) 
autoconf (4) 
autoconf (4) 
rc(8) 
wait(1) 

awk (1) 
backgammon (6) 
esh(1) 
csh(1) 
bad144(8) 
badsect(8) 
bad144(8) 
badsect(8) 
banner (6) 
banner (6) 
termcap(5) 
newaliases(1) 
ttytype (5) 
dbm (3x) 
vi(l) 
basename (1) 
be (1) 

bed (6) 
diff (1) 
yes(1) 

cb (1) 
upume (1) 
va(4) 
vfont(S) 
jO0(3M) 


from. 

whereis: locate source, 

find the printable strings in a object, or other 
uuencode,uudecode: encode/decode a 
fread, fwrite: buffered 

strip: remove symbols and relocation 
communication. 

sync: update the super 

update: periodically update the super 
sum: sum and count 

boggle: play the game of 


ching, fortune: the 

reboot: UNIX 

mille: play Mille 

switch: multi-way command 

brk, sbrk, 

login,/ sh, for, case, if, while, :, 


e794. 


fg: 


fread, fwrite: 

stdio: standard 

setbuf: assign 

mknod: 

config: 

renice: alter priority of running process 

apropos: locate commands 

man: find manual information 

mkstr: create an error message fle 

ttytype: data base of terminal types 

swab: swap 

cc 

cb: 

lint: a 

xstr: extract strings from 

mkstr: create an error message file by massaging 
, hypot, 

de: desk 
cal: print 


syscall: indirect system 


cu: 
maijloc, free, realloc, 

intro, errno: introduction to system 

termecap: terminal 

cribbage: the 

. cd, eval, exec, exit, export, login,/ sh, for, 


catmnan: create the 

uncompact, ccat: compress and uncompress files, and 
signal: 

SIgSYS: 

default: 

Cat: 


compact, uncompact, 


, break, continue, 
fabs, floor, 

fabs, floor, ceil: absolute value, floor, 
brk, sbrk, break: 
chdir: 

chsh: 

cd: 

chdir: 

chfn: 

passwd: 


/case, if, while, :, 


bg: place job in background. : 

biff: be notified if mail arrives and who Ae iS 
binary, and or manual for program. 

binary, file. strings: . 

binary file for tranmission via ail: 

binary input/output. 

bits. ; 

bk: line discionne for macRInG: Machine: 
block. 

block. ; 
blocks in a file. 
DOMRISS | Ge tae See he 
boggle: play the game of boggle. 
book of changes and other cookies. 
bootstrapping procedures. 

Bournes. 
branch. 
break: change ¢ core allocation. 
break, continue, cd, eval, exec, 
break: exit while/foreach loop. 
breaksw: exit from switch. 
bring job into foreground. ; 
ork, sbrk, break: change core alleeation: 
buffered binary input/output. 

buffered input/output package. 
buffering to a stream. 

build special file. eet wes . 
Build system configuration files. 

by changing nice. 

by keyword lookup. : 

by keywords: print out the mana 

by massaging C source. 

by port. .... ee ee 
DVIES.. aivtvce &.8) Yds a 
C compiler. ..... 
C program beautifier. 

C program verifier. Mi walsh Bani, He's 
C programs to implement shared strings. 
SOURCE: 6. oe MH te 

cabs: Euclidean distance. 

cal: print calendar. 

calculator. 
CAlIGNGAR. a <es ay Se, 2) es 
calendar: reminder service. 
Galle. uh. G Ja. See See. Ge eee 
call: ring a telephone. 

call UNEX.. 22 ene eh 
calloc: main memory allocator. 
calls and error numbers. 
capability data base. 
card game cribbage. a a ae 
case, if, while, :, ., break, continue, 

case: selector in switch. 

cat: catenate and print. 

cat files for the manual. 

cat thern. compact, 

caich or ignore signals. 

catch or ignore signals. 

catchall clause in switch. 

catenate and print. 

catman: create the cat files for the aatiual: 

cb: C program beautifier. 

ce: C compiler. ...... . 
ccat: compress and nconiprese files, and cat hen. 
ed: change directory. 

cd: change working dicectory: i eat ate arg 
cc, eval, exec, exit, export, login, newete: read,/ 
ceil: absolute value, floor, ceiling functions. 

ceiling functions. 


2s ee e® ee «@ 


© @ j@® @® 6&6  S&  &®  @ @®  &  @®  @  &®  @® oe  e®  @ 


exit, export, 


6 8& e® e®  e 


e® 8® e® e se 8 @® 6 @¢ #® 8®  e@ 


change core allocation. ; 
change current working directory. 
change default login shell. 
change directory. 
change directory. ion 
change full name of user. 
change login password. 


# 


* *® e¢ ee 8 @ 
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Permuted Index 


esh(1) 
biff (1) 
wheres (1) 
strings (1) 


uuencode (iC) 


fread(3S) 
strip( 1) 

bk (4) 
sync(8) 
update (8) 
sum (1) 
boggie (6) 
boggle (6) 
ching (6) 
reboot(8) 
mille (6) 
esh(1) 

brk (2) 
sh{1) 
esh(1) 
csh(1) 
csh(1) 

brk (2) 
fread(3S) 
stdio (3S) 
setbuf (3S) 
mknod (8) 
config (8) 
renice (8) 
apropos(1) 
man(1) 
mkstr (1) 
ttytype (5) 
swab (3) 
cc(1) 
cb(1) 
lint(1) 
xstr(]) 
mkstr (1) 
hypot(3M) 
cal (1) 
de(1) 
cal(1) 
calendar(1) 
syscall(2) 
call(1C) 
cu(1C) 
malloc(3) 
intro (2) 
termcap(5) 
cribbage (6) 
sh(1) 
esh(1) 
cat(]) 
catman (8) 
compact(!) 
signal (2) 
sigsys (2)) 
csh(1) 
cat(1) 
catman(8) 
cb (1) 
ce(1) 
compact(1) 
esh(}) 
cd(1) 
sh(1) 
floor (3M) 
floor (3M) 
ork (2) 
chdir (2) 
chsh(1) 
esh(1) 
esh(1) 
chfn(1) 
passwd (|) 


Permuted Index 


chmod: 

chmod: 

umask: 

chown: 

chown, chgrp: 

Sel: 

cd: 

ching, fortune: the book of 

renice: alter priority of running process by 
pipe: create an interprocess 

ungetc: push 

isspace, ispunct, isprint, iscntri, isascil: 
eqnchar: special 

getc, getchar, fgetc, gerw: get 

_putc, putchar, fputc, putw: put 

ascii: map of ASCII 

style: analyze surface 

tr: translate 

snake, snscore: display 


dcheck: file system directory consistency 
icheck: file system storage consistency 
fsck: file system consistency 

checkor: 

eqn, neqn, 


chess: the game of 


chown, 
cookies. 


cifplot 


ispunct, isprint, iscntrl, isasci: character 
default: catchall 
uuciean: uucp spool directory 


ciri: 

clear: 

feof, ferror, 

esh: a shell (command interpreter) with 
cron: 

close: 


shutdown: 
fclose, filush: 


autoconf: diagnostics from autoconfiguartion 
pi: Pascal interpreter 


log. dmesg: 


colrm: remove 

files. 

exec: overlay shell with specified 
time: time 

system: issue a shell 
test: condition 

time: ume a 

gélarg, iargc: 

nice, nohup: run a 
switch: multi-way 
UUX! UMIX tO UNIX 
neirm: remove a 
rehash: recornpute 
unhash: discard 
hashstat: print 


change mode. 4 

change mode of file : 

change or display file creation mack. 
change owner and group of a file. 
change owner or group. P 
change value of shell variable. 
change working directory. 

changes and other cookies. a 


Chariging® Nice; ac oa Soe we ew 

channel. ih whe ap, as i He 

character back into input ae anaes 
character classification. /isdigit, isalnum, . . 
character definitions for eqn. 

character or word from stream. ...... 2+ 
character or word on a stream. aN ee eae ah AS, age 
character set. Ares ay ee Sek ae es 
characteristics of a document: 

characters. bbe Ge eG. as 

chase game. .. ; 


chase: Try to escape to killer eabols: 

chdir: change current working directions: 

chdir: change directory. ... A gg? Sonics 
check. es as, aaa 267. Se DD: cle pare RY eS os, aN 
check. dey att Sa Tee 2B Sas a> eke oer. 

check and interactive repair. . . 


check nroff/troff files. ete: “hee ie te, Me ane dee i, de 


checked: typeset mathematics. ........ 
checknr: check nroff/troff files. 

CNOSS. oes ah gee sn al ey i Wo nh GE US AE 
chess: the game of chess. .....4e-s 
chfn: change full name of user. ot 

cherp: change owner or group. 


ching, fortune: the book of changes and other : 


chmod: change mode. GP gk > Gap tee Ale Se as 
chmod: change mode of file. ead bs gi Bie, 
chown: change owner and group of a file. files 


chown, chgerp: change owner or group... 
chsh: change default login shell. .. 
CIF interpreter and plotter. ..... 
cifpiot: CIF interpreter and plotter. . 
classification. /isdigit, isalnum, isspace, 


Clause in Switeh:. «606 aoe So ow Ee he wR 


clean-up. tas ae Se ner wala aor oe Dee 
clear: clear (ertninall screen. 

Clear i-mode. .....-+.«s-. 

clear terrninal screen. . . 1. 6. 6 1 eo ew et ee 
clearerr, fileno: stream status inquiries. .... 
Caike-SyntaX  4.4.504 Hi # wae & = EOS 
ClOCK Gaemone! 2: 6) So S-es-8 So we A os 
close a file. rth eie le fe ic atch oe Ch 
close: close a file. ee ae ee eee 

close down the system at a given time. 

close or flush a stream. ...... 

Clri: clear i-nod@, gk kk ee ew ee 
cmp: compare two files. . . .. 0... 

COUR. 68S Be ONE BB ee ek 

code transiator. esa tee aia ak wa, Hh gia a8 

col: filter reverse line feeds. hs 2 ‘ 
colert: filter nroff output for CRT areviewing: 
collect system diagnostic messages to form error 
colrm: remove columns from a Ale. Aut 
columns from a file. ae ee ee — 
comm: select or reject lines common to two ‘sorted 
command. bo idole eh age ake oO a a es ee cae 
command. Se Ae eal eee, BR, Se ce, Se, PG! 
command. Go Bs og tas ote ee a> tae ae wh ee J 
command. CE ae oe de Be SI RE 
command. aS od: ee ee 
command arguments to FOUUEN: 4.6% #4. 
command at low priority (shoniy). ... 
command branch. ee. Jed at. eis casa a. 
command ¢xecution. ..... és 


command from the network sie e) du a: eh as 


command hash table. . . 2... 2 © «© es ee 
command hash table. .......4.606+8-s 
command hashing statistics. . 
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chmod(1) 
chmod (2) 
esh(1) 
chown (2) 
chown (8) 
esh(1) 
cd(]) 

ching (6) 
renice (8) 
pipe (2) 
ungetc(3S) 
ctype (3) 
eanchar(7) 
getc(3S) 
putc(3S) 
ascii(7) 
style (1) 
tr(1) 
snake (6) 
chase (6) 
chdir (2) 
csh(1) 
dcheck (8) 
icheck (8) 
fsck (8) 
checknr (1) 
eqn(1) 
checknr(1) 
chess (6) 
chess (6) 
chfn(1) 
chown (8) 
ching (6) 
chmod (1) 
chmod (2) 
chown(2) 
chown (8) 
chsh(1) 
cifplot (1) 
cifplot(]) 
ctype (3) 
esh(1) 
uuclean(1C) 
clear(1) 
clri(8) 
clear (1) 
ferror(3S) 
esh(1) 


‘cron(8) 


close (2) 
close (2) 
shutdown (8) 
fclose (3S) 
clri(8) 
cmp(1) 
autoconf(4) 
pi(l) 

col (1) 
colert(1) 
dmesg (8) 
colrm (1) 
coirm(1) 
comm (1) 
esh(1) 
csh(1) 
system (5) 
test(1) 
time (1) 
getarg (3f) 
nice (1) 
esh(]) 
uux(1C) 
netrm (1) 
esh(1) 
csh(1) 
esh(]) 


nohup: run 

csh: a shell 

whatis: describe what a 
readonly, set, shift, times, trap, umask, wait: 
net: execute a 

repeat: execute 

rc: 

onintr: process interrupts in 
goto: 

else: alternative 

intro: introduction to 

at: execute 

apropos: locate 

while: repeat 

lastcomm: show last 
source: read 

comm: select or reject lines 
bk: line discipline for machine-machine 
dh/dm: DH-11/DM-11 

dz: DZ-\1 

users: 

files, and cat them. 

diff: differential file and directory 
cmp: 

diff3: 3-way differential file 
uudiff: directory 

liszt: 

ccc 

f77: Fortran 77 

pc: Pascal 

error: analyze and disperse 
yacc: yet another 

wait: wait for background processes to 
wait: await 

compact, uncompact, ccat: 
learn: 

hangman: 

. test: 

endif: terminate 

if: 

while: repeat commands 


config: Build system 


dcheck: file system directory 
icheck: file system storage 
fsck: file system 

cons: VAX-1]1 


show what versions of object modules were used to 


mkfs: 

deroff: remove nroff, troff, tbl and eqn 
vlimit: control maximum system resource 
badsect: create files to 

Is: list 

netq: print 

sh, for, case, if, while, :, ., break, 


ioctl, stty, gity: 

jobs: summary of job 

init: process 

Viimit: 

vhangup: virtually ““hangup’’ the current 
up: unibus storage module 

terminals: 

ecvt, fevt, gcvt: output 

printf, fprintf, sprintf: formatted output 
scanf, fscanf, sscanf: formatted input 
units: 


dd: 

number: 

arcy: 

ranhb: 

atof, atoi, atol: 

i3tol, ltol3: 

ctime, localtime, gmtime, asctime, umezone: 
bed: 


command immune to hangups. Pare 
(command interpreter) with C-like syntax. 
command is. id 


command language. jexport, login, newerp, read, 


command on a remote machine. 

command repeatedly. 

command script for auto-reboot and daemons: 
command scripts. ie cat es 

command transfer. .... 

commands. : 
commands. ee eee 
commands at a later me:, 
commands by keyword lookup. 

commands conditionally. 

commands executed in reverse ander. 
commands from file... , 

common to two sorted files. 
communication. .. , 
communications muldolexer, 
communications multiplexer. 

compact list of users who are on the cient. 


compact, uncompact, ccat: compress and ancompcess 


comparator. ..... . 
compare two files. 
comparison. ..... 


comparison between achines: 
compile a Franz Lisp program. 
compiler. Kis ee ate ee en ae 
compiler. ..... 
compiler. eA Se ae 


compiler error messages. ..... ; 
compiler-compiler. ...... ' 
COMODIGLE. «604.30. > a GS: Gee e- & B 
completion of process. ‘ ' ; 


compress and uncompress files, aad eat theni. 
computer aided instruction about UNIX. 
Computer version of the game hangman. 
condition command. 

conditional. ; 

conditional statement. 

conditionally. 

config: Build system conhauration files. 
configuration filles. ..... 

cons: VAX-11 console interface. 
consistency check. ..... 


consistency check. hee te ta 

consistency check and interactive cepait: 
console interface. a a ae 
construct a file. what: Bee Pores, Fen oe 
construct a Ale system. ....... ; 
constructs. sis, tase he eave? ty age Se ; ; 
consumption. ete A HS ear ae SH 
contain bad sectors. 6 Ee ee ae Oe 
contents of directory. ......0..4 


contents of network queue. Sid ie fete: HEY 
continue, cd, eval, exec, exit, export, login./ 


continue: cyclein loop. .......e8-. 
control device. ...... 62668. 
control facilities. ......4.. 


control initialization. as ag Sed : 


control maximum system resource consumption: 


control terminal. ....4.4.. 
controller/drives. A 
conventional names. - 
conversion. 

conversion. : 

conversion. 

conversion arourain: 

convert and copy a file. 

convert Arabic numerals to English: 
convert archives to new format. 
convert archives to randorn libraries. 
convert ASCII to numbers. 


convert between 3-byte integers and ane sgtegee: 


convert date and time to ASCII. 
convert to antique media. ...4.... 
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esh(1) 
esh(1) 
whatis(1) 
sh(1) 
net(1) 
esh(]) 
rc(8) 
esh(]) 
esh(1) 
esh(1) 
intro(1) 
at(t) 
apropos (1) 
esh(1) 
lastcomm(]) 
esh(1) 
comm (1) 
bk (4) 

dh (4) 
dz(4) 
users(]) 
compact! i) 
diff (1) 
emp(1) 
diff3(1) 
uudiff (1C) 
liszt(1) 
cc(1) 
(771) 
oc(1) 
error(1) 
yacc(]) 
esh(1) 
wait(1) 
compact (1) 
learn(1]) 
hangman (6) 
test (1) 
esh(1) 
esh(1) 
esh(1) 
config (8) 
config (8) 
cons (4) 
dcheck (8) 
icheck (8) 
fsck (8) 
cons(4) 
what(1) 
mkfs(8) 
deroff(1) 
viimit(2v) 
badsect(8) 
Is(1) 
netq(1) 
sh(1) 
csh(1) 
ioct! (2) 
jobs (3}) 
imit(8) 
vlimit(2v) 
vhangup(2v) 
up(4) 
term(7) 


_ ecvt(3) 


print{(3$) 
scum! (35) 
umits( 1) 
dd(l) 
number!6) 
arcv (8) 
raniib(1) 
atof(3) 
3tol(3) 
ctime (3) 
bed (6) 
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ching, fortune: the book of changes and other 
arff, flcopy: archiver and 

cp: 

uucp, uulog: unix to UNIX 

dd: convert and 

netcp: remote 

brk, sork, break: change 

savecore: save a 


functions. sin, 
sinh, 

we: word 

sum: sum and 


analyze: Virtual UNIX postmortem 
crash: what happens when the system 


creat: 

ctags: 

mkstr: 

pipe: 

Mpx: 

badsect: 

catman: 

umask: change or display file 
umask: set file 

cribbage: the card game 


ixref: lisp 

pxref: Pascal 

colert: filter nroff output for 
more, page: file perusal Alter for 


syntax. 
newcsh: description of new 


convert date and ume to ASCII. 


‘“*hangup’’ the 
jobs: print 
whoami: print effective 
chdir: change 
motion. 
curses: screen functions with “optimal” 
spline: interpolate smooth 
continue: 
cron: clock 
rc: command script for auto-reboot and 
eval: re-evaluate shell 
prof: display profle 
ttys: terminal initialization 
termcap: terminal capability 
newaliases: rebuild the 
ttytype: 
dbminit., fetch, store, delete, firstkey, nextkey: 
rhull: 
types: primitive system 
join: relational 
date: print and set the 
time, flime: get 
localtime, gmtume, asctuume, timezone: convert 
touch: update 


vhangup: virtually 


data base subroutines. 


dump, 

adb: 

sdb: symbolic 
badi44: read/write 
tp: 


COOKICS. 

copier for floppy. 

copy. 

CcOpy. 

copy a file. 

copy of files through ine fiat. 

core allocation. 

core dump of the pee aune Sveieen. 
core: format of memory image file. 
cos. tan, asin, acos, atan, atan2: ingonomeine: 
cosh, tanh: hyperbolic functions. 


count. oe ge ig a a ee Ae 
count blocks ‘aeaoals: er ee 

cp: copy. Oe ae ae Sen-k 

crash analyzer. ... : 


crash: what saa whet the system crehes.. 
crashes. ; SoU. cy 

creat: create a new file. 

create a new file at. Se TAGs ooh cas aes Be 
create atags file. .... : 
create an error message file by inassaginig Cc source. 
create an interprocess channel. 


create and manipulate multiplexed files. a eee 


create files to contain bad sectors. 


create the cat files for the manual. .......... 
KTEAUION MASK... 4.28. Ge. Kae Rl ca Be wes Ce He SR wee 8 
creation mode mask. ......+.s.«+-e+s«eeeee 


cribbage. 
cribbage: the card game ‘cribbage. 
cron: clock daemon. 

cross reference program. 
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cross-reference program. . 2. 2. 2 2 6 6 ee we ew 


CRT previewing. 

crt viewing. —. bee aie. ep sdb se tet ag tes Tees ae ete ot 
crypt: encode/decodé: a, a ee ae ee ee 
crypt, setkey, encrypt: DES encryotion: — > kee od 
esh: a shell (command interpreter) with C- like 

csh features (over oldesh). ........ 200. 
ct: phototypesetter interface. Bee, ee, ede cle ah 
Clags: create a tags file. 

ctime, localtime, gmtume, asctime, timezone: 

cu: call UNIX. 
current control terminal. 

current job fist. ae ; 

current user id. bes eh eth Shag: i cain See, EO 


current working diceciory: : be A oe ate ah es 38 


curses: screen functions with “optimal” cursor 
CUISOF MOTION. se 6.56 Se terce, Sevee aos 

curve. be ct dee tas de> <n es. Bee ee ALB hs hE le ee Gt 
cycle in loop. odes eR te OR al ae ae se Bis lec 
daemon. 
daemons. 
data. 
data. 
data. 
data base. a ee ae 
data base on. the eal aiases file. wh oe ee ee eg 
data base of terminal types by port. 

data base subroutines. ; 
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data types. ee eae 

database operator. ..... s : 
date. od, ya Boe ee 


date and time... 

date and time to ASCII. “ime: 

date last modihed of a flle. 

date: print and set the date. : 

dbmiunit, fetch, store, delete, Arsikey, exeey: 
Gc: desk calculator. 

dcheck: file system Giréciory: eansisiency cheek: 
dd: convert and copy a Ale 

cadate: incremental dump format. A 
debugger. 
debugger. 
dec standard 144 bad sector information. Se det. xe 
DEC/mag tape formats. i: Vid ee Yai DES Wh ve SS es RO ee 
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ching (6) 
arff(8) 
cp(1) 
uucp(1C) 
dd(1) 
netcp(1) 
brk (2) 
savecore (8) 
core (5) 
sin(3M) 
sinh(3M) 
we(1) 

sum (1) 
cp(]) 
analyze (8) 
crash (8) 
crash(8) 
creat(2) 
creat (2) 
ctags(1) 
mikstr (1) 
pipe (2) 
mpx (2) 
badsect (8) 
catman (8) 
esh(1) 
umask (2) 
cribbage (6) 
cribbage (6) 
cron(8) 
Ixref(1) 
pxref(1) 
colert(1) 
more (1) 
crypt(1) 
crypt(3) 
esh(]) 
newcsh (1) 
ct(4) 
ctags(1) 
ctime (3) 
cudic) 
vhangup(2v) 
esh(1) 
whoami(1) 
chdir(2) 
curses(3) 
curses (3) 
spline (1G) 
csh(1) 
cron (8) 
re(8) 
esh(1) 
prof(1) 
itys(5) 
termcap(5) 
newaliases(1) 
ttytype (5) 
dbm (3x) 
null (4) 
types (5) 
join(!) 
date(1) 
time (2) 
cume (3) 
touch (1) 
date (1) 
dbm (3x) 
de(1) 
dcheck (8) 
dd(1) 
dump(5) 
adb(1) 
sdb (1) 
bad144(8) 
tpiS) 


chsh: change 

eqnchar: special character 
dbminit, fetch, store, 
delivermail: 

tail: 

aliases: aliases file for 


mesg: permit or 

constructs. 

crypt, setkey, encrypt: 

whatis: 

newcsh: 

dup, dup2: duplicate an open file 

getfsfile, setfsent, endfsent: get file system 
dc: 

access: 

file: 

drum: paging 

fold: fold long lines for finite width output 
ioctl, stty, gtty: control 

vswapon: add a swap 

swapon: specify additional 


dh/dm: 


dmesg: collect system 

autoconf: 

ratfor: rational Fortran 

print wordy sentences; thesaurus for 
print wordy sentences; thesaurus for 
for diction. 

for diction. 


diff: 
diff3: 3-way 


dir: format of 

cd: change working 

chdir: change current working 
cd: change 

chdir: change 

Is: list contents of 

mkdir: make a 

uuclean: uucp spool 

diff: differential file and 
uudiff: 

dcheck: file system 

unlink: remove 

mklost +found: make a lost+found 
pwd: working 

old: 

mknod: make a 

popd: pop shell 

pushd: push shell 

unhash: 

unset: 

bk: line 

hk: RK6-11/RK06 and RKO7 moving head 
RPO6, RM03, RM05, RM80. RPO? MASSBUS moving-head 
df: 

du: summarize 

format: how to format 
mount, umount: mount and 
error: analyze and 

rain: animated raindrops 
snake, snscore: 

vi: screen oriented (visua!) 
umask: change or 

prof: 

worms: animate worms On a 
nypot, cabs: Euclidean 

error log. 


style: analyze surface characteristics of a 


default: catchall clause in switch. 
default login shell. 

definitions for eqn. 

delete, firstkey, nextkey: data base subroutines. 
deliver mail to arbitrary people. 

deliver the last part of a file 

delivermail ......2.. — 
delivermail: deliver mail to anbitnacy people 
deny messages. . 

deroff: remove nroff, troff, tbl nds ean. 
DES encryption. 

describe what a somane: [Si- wt Be of boi ee A 
description of new csh features (over oldcsh). 
CESCFIDIOR: | a we de K. G8 

descriptor file entry. getfsent, eles pee: 

desk calculator. a : 

determine accessibility of file. 

determine file type. 

device. 
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device. ..... 

device for interleaved: Aging ewappines 

device for paging and swapping. 

df: disk free. ee ar eee ee 
DH-11/DM-11 Sonmunications a ultimlexer 
dh/dm: DH-11/DM-11 communications multiplexer. 
diagnostic messages to form error log. 
diagnostics from autoconfiguartion code. 
Cidgl@Ch, «ke GOR we 

diction. diction,explain: 
diction. diction,explain: 
diction,explain: print wordy sentences: ihesauews 
diction,explain: print wordy sentences, thesaurus 
diff: differential file and directory comparator. 
diff3: 3-way differential file comparison. 
differential file and directory cornparator. 
differential file comparison. 

dir: format of directories. 

directories. 
directory. 
directory. 
directory. 
directory. 
directory. 
GireCtOry: << cm How Aa ee 
directory clean-up. 

GiTeCtOry COMParalon,. ss es es HS Se et SS 
directory comparison between machines: 
directory consistency check. 

directory entry. 
directory for fsck. 
directory name. 
directory of old programs. 
directory or a special file. 
directory stack. 
directory stack. gis 
discard command hash table 
discard shell variables. =... @ eee © owe Wes 
discipline for machine-machine communicauon. 

ISS coe el Boe ae ee Se 

disk. hp: 
disk free. 
disk usage. 
disks. 
dismount file system. ; 
disperse compiler error messages. 
GiSPIAV.. 2-4. SO. YU Ae Ba we Se Ee ES 
display chase game. 
display editor based on ex. 
display file creation mask. 
display profile data. 
display terminal. 
GiStance:. fovea: oe oer & SE He. ee Se 
dmesg: collect svstem d: eHOstic messages to fotar 
doctor: interact with a psychoanalyst. 
document. 
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esh(1) 
chsh(1) 
eaqnchar(7) 
dbm (3x) 


delivermail (8) 


tail(1) 
aliases (5) 


delivermail(§) 


mesg (1) 
deroff(1) 
crypt(3) 
whatis(1) 
newcsh(1) 
dup(2) 
getfsent(3) 
dce(1) 
access (2) 
Ale (1) 
drum (4) 
fold (1) 
ioctl (2) 
vswapon(2v) 
swapon(8) 
df(1) 
dh(4) 

dh (4) 
dmesg (8) 
autoconf (4) 
ratfor(1) 
diction(1]) 
explain (1) 
diction(1) 
explain(1) 
diff (1) 
diff3 (1) 
diff (1) 
diff3 (1) 
dir (5) 

dir (5) 


mkdir (1) 
uuclean(1C) 
diff (1) 
uudiff(1C) 
dcheck (8) 
unlink (2) 


mkiost ~found(8) 


pwd (1) 
old (8) 
mknod(2) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 

bk (4) 

hk (4) 

hp (4) 
df(1) 
du(1) 
format(8) 
mount(8) 
error(]) 
rain(6) 
snake (6) 
vill) 
esh(1) 
prof (|) 
worms (6) 
hypot(3M) 
dmesg(8) 
doctor (6) 
stvle (1) 
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lookbib: find and insert literature references in 
w: who is on and what they are 

rogue: Exploring The Dungeons of 

shutdown: close 

graph: 

arithmetic: provide 

rewind: rewind tape 

newtty: summary of the “‘new’’ tty 


dump: incremental file system 
od: octal 
dump, ddate: incremental 


savecore: save a core 
dumpdir: print the names of files on a 


zork: the game of 
rogue: Expioring The 


ca. 


dup, 
dup, dup2: 
dz: 

aliens: The alien invaders attack the 
echo: 

echo: 


end, etext, 

eX, 

vIpw: 

ed: text 

ex, edit: text 

id: link 

sed: siream 

vi: screen oriented (visual) display 
a.out: assembler and link 
whoami: print 

vfork: spawn new process in a virtual memory 


grep, 
soelim 


uuencode: format of an 
crypt: 

uuencode, uudecode: 
crypt, setkey, 

crypt, setkey, encrypt: DES 
makekey: generate 


mail. 


logout: 


getfsent, getfsspec, gerfsfiie, setfsent, 
getgrent, getgrgid, getgrnam, setgrent, 


getpwent, getpwuid, ge(pwnam, setpwent, 


number: convert Arabic numerals to 

xsend, xget, 

nlist: get 

setfsent, endfsent: get file system descriptor Ale 
getgrnam, setgrent, endgrent: get group file 
geipwnam, seipwent, endpwent: get password file 
unlink: remove directory 

execv, execle, execve, execip, execvp, exec, exece, 


setenv: set variable in 

environ: user 

printenv: print out the 

getenv: value for 

unsetenv: remove 

eqnchar: special character definitions for 


Fad 


documents. refer, 
doing. Sr, Th 


Doom. .. : os oe : 
down the system a a given time. 
draw a graph. ie Mer SS. SE Maes | 
drill in mumber facts. ..... 
BEING «gi er des ae Oe he Sa Ts me ee SA 
driver. Ue, 2G ewe, Go ae es ae 
drum: paging device. ....4... 
du: summarize disk usage. i. ee hs 
dump. fo SM ds “ee a Jee SS We ee Se He 
dump. «“. % ‘ : . a ae 


dump, ddate: incremental dump format. 
dump ToOrmnate «1c a 4 aoe ce m 
dump: incremental file system dump. 
dump of the operating system. 

dump tape. + A 


dumpdir: print the r names of files ona ieduimie 


dungeon. ® e a o o e ® @ @ ¢ e « 
Dungeons of Doom. ... ; 


e a 


e ® e 
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dup, dup2: duplicate an open file escripiors 


dup2: duplicate an open file descriptor. 
duplicate an open file descriptor. 


dz: DZ-11 communications multiplexer. 


DZ-11 communications multiplexer. 
CAV: #6) Sum ae tercacte wate. Sty & 
echo arguments. . . 2. 6 eo 
echo arguments. 2... 1 6 a es 
echo: echo arguments. a cae ad we ee 2 
echo: echo arguments. ae ka? a a 
ecvt, fevt, govt: output conversion. 
OOTAEXUCGNO: ce wh ence SE wt he ve 
edata: last locations in program. 

edit: texteditor. .... bs tee Ft 
edit the password file with vi. oo... 
editor. Fe Oe en Bs GLANS 
editor. Se Ge.per ate ae eb ade ee Anes 
editor. Be Wek. pa ne. des Se is SP ae ss wee, 
editor. be. Bee, Be I, She ee es ER 
editor based on ex. ..... 2.6. 
editor output. Sts be ee Bee: 
effective current user J: i is Pe 
efficient way. gt ths ellen tos BR, a oe, 
efl: Extended Fortran Lanauage: 
egrep, fgrep: search a file for a pattern. 
eliminate .so’s from nroff input. . 
elise: alternative commands. 

encoded uuencode fle. ...... 
encode/decode. 2 segs“ : 


encode/decode a binary fil le for (canmmasion via 


encrypt: DES encryption. ... ., 
encryption. Ue Ab tn, 086 See ap segs Be ee 
encryption key. Date. OP te, 'oy og 


end, etext, edata: last locations in program. 


CNG SESSION: aed oe Be SS RS 
end: terminate loop. ch ges 

endfsent: get file system descriptor file 
endgrent: get group file entry. .. . 
endif: terminate conditional. eats 

endpwent: get password file entry... 
endsw: terrninate switch. eS We Mise ok 
Englishs. « «4's & ee & wee 2% 
enroll: secret mail, oo. 6... 0 ee 
entries from name list. . .. Yack 
entry. getfsent, getfsspec, getfsfile, 

entry. getgrent, getgrgid, ..... 
entry. getpwent, getpwuid, .. . 

BAU: ola eee re ee es 
environ: execute a file. execl, ... 
environ: user environment. ... . 
environment. WPS. tee see See 3) aE: SE, 
environment. OM ee See ae. ca See 
environment. Beier bn OR eae ke, we Se ie 


environment name. St Bad's ae 
environment variables. Ce ca tals pay, YE ask 
ecn. @ e a 6 a ge cy 2 e @ @ ¢ 6 8 
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refer(1) 
w(]) 

rogue (6) 
shutdown (8) 
graph(IG) 
arithmetic(6) 
rewind(1) 
newtty (4) 
drum (4) 
du(1) 
dump(8) 
od (1) 
dump(5) 
dump(5) 
dump(8) 
savecore(8) 
dumpdir(8) 
dumpdir(8) 
zork (6) 
rogue (6) 
dup(2) 
dup(2) 
dup(2) 

dz (4) 
dz(4) 
aliens (6) 
esh(1) 
echo(1) 
esh(1) 
echo(1) 
ecvt(3) 
ed(1) 
end(3) 

ex (1) 
vipw(8) 
ed(1) 

ex (1) 

ld(1) 
sed(1) 
vi(1) 
a.out(S) 
whoami(1) 
vfork (2v) 
efl(1) 
grep(1) 
soelim (1) 
esh(1) 
uuencode(5) 
crypt(1) 
uuencode(1C) 
crypt(3) 
crypt(3) 
makekey (8) 
end(3) 
esh(1) 
esh(1) 
getfsent(3) 
getgrent(3) 
esh(1) 
getpwent(3) 
esh(1) 
number (6) 
xsend (1) 
nlist(3) 
getfsent(3) 
getgrent(3) 
getpwent(3) 
unlink (2) 
exec(2) 
environ(S) 
esh(1) 
environ(5) 
printenv (1) 
getenv(3) 
esh(1) 
egnchar (7) 


deroff: remove nroff, troff, tbl and 


numbers. intro, 

messages. 

dmesg: collect system diagnostic messages to form 
mkstr: create an 

error: analyze and disperse compiler 

perror, sys_errlist, sys_nerr: system 

intro, errno: introduction to system calls and 
eyacc: modified yacc allowing much improved 
spell, speilin, spellout: find spelling 

chase: Try to 

end, 

hypot, cabs: 

/if, while, :, ., break, continue, cd, 

expr: 

history: print history 
screen oriented (visual) display editor based on 


execi, execy, execle, execve, execip, execvp, 
/while, :, ., break, continue, cd, eval, 


execl, execv, execie, execve, execip, execvp, exec, 
exece, environ: execute a file 

environ: execute a file. execl, execv, 
file. execl, execv, execle, execve, 
sticky: 

net: 

execve, execip, execvp, exec, exece, environ: 
repeat: 

at: 

lastcomm: show last commands 

uux: unix to unIx command 

acct: 

sleep: suspend 

sleep: suspend 

monitor: prepare 

pxp: Pascal 

profil: 

pix: Pascal interpreter and 

environ: execute a file. execl, 

execute a file. execl, execv, execie, 
execl, execv, execle, execve, execip, 
/:, ., break, continue, cd, eval, exec, 
breaksw: 


break: 

power, square root. 

glob: filename 

expand, unexpand: 

versa. 

aardvark: yet another 

adventure: an 

rogue: 

frexp, ldexp, modf: split into mantissa and 
exp, log, log10, pow, sart: 

/ ., break, continue, cd, eval, exec, exit, 


expr: evaluate arguments as an 
re_comp, re_exec: regular 

efi: 

greek: graphics for 

strings. xstr: 

recovery. 


functions. 

jobs: summary of job control 

arithmetic: provide drill in number 

pstat: print system 

true, 

abort: generate a 

export, login,/ sh, for, case, if, while, : 
exit, export, login,/ sh, for, case, if, whit é, 


3 


eqn constructs. brie. te oy a : 

eqn, neqn, checkea: eke! satne mate? 
eaqnchar: special character definitions for eqn. 
errno: introduction to system calls and error 
error: analyze and disperse compiler error 

error log. Me Yes ie ected Sen he (ae ae ee ee ae? A a 
error message file by massaging C source. aha 
error messages. ‘ “cs 
error messages. Ge ay. Oe ya 


error numbers. fee we eee Boies ee eas ag 
error recovery. ; Gn th, Ae, ee sas a 48 vende Ma Gat. 
errors. ds Bane a ek ae S 


a @ ® e o ® 9 r) 


escape to killer robots. 2... 1 we we ee 
etext, edata: last locations in program. .... 


Euclidean distance. ..... a a ee ee 
eval, exec, exit, export, login, sewenn: read,/ . 

eval: re-evaluate shell data. . . 2... 2. 1 eee 
evaluate arguments as an expression. de, Me eG GB 


CVENCISI: “2.0 acid: doh ae Haw 
Ox WAG, + le 2 eng, Bes BA ee eae he Se Gee We ae HA, 
ex, edit: text editor. Be Bade. G1 0h ey. Ge cas Bes Se ee 
exec, exece, environ: execute a file. ...... 
exec, exit, export, login, newerp, read, readonly,/ . 
exec: overlay shell with specified command. .... 
exece, environ: execute a file. ......4.4.+. 
execi, execv, execlé, execve, execip, execvp, exec, 
execie, execve, execip, execvp, exec, exece, 
execip, execvp, exec, exece, environ: execute a 
executable files with persistent text. 
execute a command on a remote machine. 
execute a file. execl, execv, execle, 
execute command repeatedly. 
execute commands at a later time. 
executed in reverse order. 
execution. .... . i & 


e 


execution accounting fle: une Bod i 
execution for an interval. gh an we ee Ss j.% 
execution for interval. She, Ae ane eo, Bh ee te 
execution profile. i ante Wan Gah Re Ae ee Ge ae 


execution profiler. ...... 
execution time profile. Bea ad. yee 
CXOCCUIOR- 40m We cie He ee ot ee HS ee 
execv, execle, execve, Bxecln: execvp, exec, exece, 
execve, execip, execvp, exec, exece, environ: .. . 
execvp, exec, exece, environ: execute a file. a iB 
exit, export, login, newerp, read, readonly, set,/ : 
exit from switch, . 2. 2.0. 2 1 ee eo 
exit: leave shell, 2. 2... 1. 2 ew ee ew 
exit: terminate process. . . 1... ew we es 
exit while/foreach loop. ..... es tesatie “in Ges. Ae ad 
exp, log, log10, pow, sart: exponential, Jogarithm, . 
expand argument list. a eh cbh saa a 
expand tabs to spaces, and vice versa. 

expand, unexpand: expand tabs to spaces, ancl vice 


@ e ® 8 @ ® 


a e e @ 2 


explorauion game. Si iat Gide mt AS SE ee. He at eS 
exploration game. a8 Fy. py “day dein os ee 
Exploring The Dungeons of Door Bhd tah ae 
@XMONeNt. .< 6.4 w & BOW VAS OH aes 


exponential, logarithm, power, square root. ... . 
export, login, newerp, read, readonly, set, shift,/ . 
expr: evaluate arguments as am expression. .... 
expression. ecu Fabs, Si Tu SP Ge cap eG, Ca oR ah 
expression handler. ee Wie We de> eas Hae Moc tay’ hos a 
Extended Fortran Language. de uet tes ar we, Oe eva ae 
extended TTY-37 type-box. . . 2... 6 we — 
extract strings from C programs to implement shared 
eyacc: modified yacc allowing much improved error 


(77: Fortran 77 compiler. . . , 

fabs, floor, ceil: absolute value, floor, ceiling 
facilities. Sis ie 5 acta es ae SSA Ses He Se ee Oe 
PAGES, ue, ee ae Sa ke, we we ee a es 


FACS. ae ee ces ae ee oe Se ES 
false: provide truth values. Smit Ss es, AE ee a a 


fault. o> 8 a a 2 a J oe Ss o e cy ® o a a e c) cy oO @ 
., Dreak, continue, cd, eval, exec, exit, a a ee 
:, ., break, continue, cd, eval, exec, ... 
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Permuted Index 


deroff(1) 
eqn (1) 
eanchar(7) 
intro (2) 
error(]) 
dmesg (8) 
mkstr(1) 
error(1) 
perror(3) 
intro (2) 
eyacc(1) 
spell (1) 
chase (6) 
end (3) 
hypot(3M) 
sh(1) 
esh(1) 
expr (1) 
esh(1) 
vil) 
ex(]) 
exec (2) 
sh(1) 
esh(1) 
exec(2) 
exec(2) 
exec (2) 
exec(2) 
sticky (8) 
net(1) 
exec(2) 
esh(1) 
at(]) 
lastcomm (1) 
uux(1C) 
acct(5) 
sleep(1) 
sleep (3) 
monitor (3) 
oxp(1) 
profl(2) 
pix (1) 
exec(2) 
exec(2) 
exec(2) 
sh(1) 
esh(1) 
esh(1) 
exit(2) 
esh(1) 
exp(3M) 
esh(1) 
expand (1) 
expand (1) 
aardvark (6) 
adventure (6) 
rogue (6) 
frexp(3) 
exp(3M1) 
sh(1) 
expr(]) 
expr(]) 
regex (3) 
efl(1) 
greek (7) 
xstr(]) 
eyacc(1) 
f77(1) 
floor (3M) 
jobs (3)) 
arithmetic (6) 
pstat(&) 
true(]) 
abort (3) 
sh(i) 
sh(1) 


Permuted Index 


ecvt, 

fopen, frecpen, 

newcsh: description of new csh 
col: filter reverse line 
INQUITIES. 

feof, 

subroutnes. dbmini, 

head: give frst 

netlog: print the last 

fclose, 


getc, getchar, 

gets, 

grep, cgrep, 

locate a program file including aliases and paths 
access: determine accessibility of 

acct: execuuion accounting 

chmod: change mode of 

chown: change owner and group of a 

close: close a 

colrm: remove columns from a 

core: format of memory image 

creat: create a new 

source: read commands from 

clags: create a tags 

dd: convert and copy a 

execip, execvp, exec, exece, environ: execulé a 
group: group 

link: link to a 

mkned: make a directory or a special 

mknod: build specia! 

netlog: print the last few lines of the network log 
rebuild the data base for the maul aliases 
passwd: password 

pr: print 

read: read from 

rev: reverse lines of a 

$ize: size of an object 

the printable strings in a object, or other binary, 
sum: sum and count blocks tn a 

tail: deliver the last part of a 

touch: update date last modified of a 

unig: report repeated lines in a 

uuencode: format of an encoded uuencode 
vwrite: write (virtually) to 

versions of object modules were used to construct a 
write: write on a 

diff: differential 

mkstr: create an error message 

diff3: 3-way differential 

umask: change or display 

umask: set 

dup, dup2: duplicate an oper 


setfsent, endfsent: get file system descriptor 
getargid, geigrnam, setgrent, endgrent: get group 
geipwnam, setpwent, endpwent: get password 
grep, egrep, [grep: search a 

aliases: aliases 

uuencode uudecode: encode/decode a binary 

ar: archive (library) 

gee: see whal a 
locate a program 
split: split a 
pmierge: pascal 
mktemp: make a unique 

more, page: 

stat, fstat: get 

mikfs: construct a 

mount, umount: mount or remove 
mount, umount: mount and dismount 
repair. fsck: 

getfsspec, getfsfile, setfsent, endfsent: get 
dcheck: 

dump: incremental! 


which: 


wa? 
€% 


CHTARAAHRARAAS 


Sh Sp an teh Sh 
ea 6 


ay 


See ee Ee 


what: show 


@ 6 2 ° S 


and directory comparator. 
by massaging C source. 


comparison. 


creation mask. 


(cshonly). which: 
execl, @xecv, 
newaliases 

fi a a @ oe oe 

file 3 @ ® @ e 

fil e eo e @e a 

fi cd e 6 & 2 a 

fi o & a a @ ° 

file. strings: find 

Al 


what 


o 


a 


& 
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execle, 


& 


e 


creation mode mask. 


descriptor. 


entry. getgrent, 
entry. getpwent, getpwuid, 


for a pattern. 
for delivermail. 
for tranmission via mail. 


format. : 
has imi. 


including aliases and paths leek on! ily). 


into pieces. 


perusal filter for crt viewing. 


merger... 
name. .. 
e status. .. 
esystem.  . 
esystem. . 
e system.  . 


e system consistency check and interactive 
* system descriptor Ale entry. getfsent, 
e system directory consistency check. 

e system dump. 
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: determine file type. 
entry. getfsent, getfsspec, getfsfile, 
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execve, 
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eno: stream Status 


eo 


® 


® 
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fciose, fflush: close or flush a stream. 
fcvt, gcvt: output conversion. 
fdopen: open a stream. 
features (over oldcsh). 
feeds. ..... 
feof, ferror, clearerr, fil 
ferror, clearerr, fileno: stream status inquiries. 

feich, store, delete. firstkey, nextkey: data base 
few lines. ‘ 
few lines of the Aeiwark log file. 
Mlush: close or flush a stream. 
fg: bring job into foreground. : 
fgetc, getw: get character or word from sireant. 
fgets: get a string from a stream. 
fgrep: search a file for a pattern. 


é 
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felose (3S) 
ecvt(3) 
fopen (3S) 
newcsh (1) 
col(1) 
ferror(3S) 
ferror(3S) 
dbm(3x) 
head (1) 
netlog (1) 
fclose (3S) 
esh(1) 
getc(3S) 
gets(3S) 
grep(1) 
which (1) 
access(2) 
acct(5) 
chmod (2) 
chown (2) 
close (2) 
coirm (1) 
core (5) 
creat(2) 
esh(1) 
ctags (1) 
dd(1) 
exec(2) 
group(5) 
link (2) 
mknod (2) 
mknod (8) 
netlog (1) 
newaltases(1) 
passwd (5) 
pr(1) 

read (2) 
rev(]) 
size (1) 
strings (1) 
sum(1) 
tail(1) 
touch(1) 
uniq(1) 
uuencode(5) 
vwrite(2v) 
what(]) 
write (2) 
diff) 
mkstr(1) 
diff3 (1) 
esh(1) 
umask (2) 
dup(2) 
file(1) 
getfsent(3) 
getgrent(3) 
getpwent(3) 
grep(1) 
aliases (5) 
uuencode(1C) 
ar(5) 
see(}) 
which(1) 
split (1) 
pmerge(1) 
mktemp(3) 
more (1) 
stat(2) 
mkfs(8) 
mount(2) 
mount(8) 
fsck (8) 
getfsent(3) 
dcheck (8) 
dump (8) 


hier: 

quot: summarize 

restor: incremental 

icheck: 

mtab: mounted 

filsys, flblk, ino: format of 

utime: set 

uusend: send a 

file: determine 

vipw: edit the password 

basename: strip 

glob: 

feof, ferror, clearerr, 

checknr: check nroff/troff 

cmp: compare two 

comm: select or reject lines common to two sorted 
config: Build system configuration 

find: find 

intro: introduction to special 

mpx: create and manipulate multiplexed 
mv: move or rename 

rm, rmdir: remove (unlink) 

sort: sort or merge 

compact, uncompact, ccat: compress and uncompress 
catman: create the cat 

dumpdir: print the names of 

netcp: remote copy of 

badsect: create 

Sticky: executable 

fstab: static information about the 


more, page: file perusal 
colert: 

col: 

plot: graphics 

refer, lookbib: 

find: 


look: 

manual. man: 
ttyname, isatty, ttyslot: 
lorder: 

spell, spellin, spellout: 
binary, file. strings: 


fold: fold Jong lines for 
head: give 

dbminit, fetch, store, delete, 
fish: play ‘“Go 


nice, nohup: run a command at low priority 
tee: pipe 


filsys, 

arff, 

functions. fabs, 

fabs. floor, ceil: absolute value, 
arff, flcopy: archiver and copier for 
fl: 

fclose, Mush: close or 


device. 

fold: 

vfont: 

inspect and print out information about unix 


continue, cd, eval, exec, exit, export, login,/ sh, 
fg: bring job into 


dmesg: collect system diagnostic messages to 
ar: archive (ibrary) file 

arcv: convert archives to new 

dump, ddate: incremental dump 

format: how to 


file system hierarchy. 

file system ownership. 

file system restore. : 

file system storage consi icag) eneek. 
file systern table. 

file system volume. 

file times. a ae 

file to a remote host. 

Ale type. 
file with vi. 
filename affixes. 

filename expand argument ist. 

fileno: stream status inquiries. 

files. i ee ae Oe are Bate 

G1eSis xc. ov ow KON Oe bi 

Mess. a: hes es Se ee 

files, ....... 

MIGS.- . 25, cece we ae Ss Ee 

files. gre a ales Sn, Sie oh 

files. 

files. ok, Alto ae a ost eye 

files. she ahcigis stan Ras 2h 

files. 

files, ane eat ‘them. 

files for the manual. 

files on a dump tape. 

files through the net. 

files to contain bad sectors. 

files with persistent text. 

filesystems. ...... 

filsys, flblk, ino: format of file Systeni volume, 
filter for crit viewing. . ‘ 

filter nroff output for CRT previewing. 

filter reverse line feeds. ae 

F@ESS ss es one. SS : 
find and insert literature teleccnces in ndocoments: 
find files. 

find: find Ales. . ..... 
find lines in a sorted list. 

find manual information by bavwords: Brit oul the 
find name of a terminal. : 

find ordering relation for an object library 

find spelling errors. ; 
find the printable strings in a aie or other 
finger: user information lookup program. 

finite width output device. 

first few lines. ; 

frstkey, nextkey: dats Bace cubroutnes: 
Fish” , 

fish: play “Go Fish” 

(sh only). 
fitting. 
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fl: floppy interface. . 

fibik, ino: format of file en: eolone: 
flcopy: archiver and copier for floppy. 
floor, ceil: absolute value, floor, ceiling 
floor, ceiling functions. 
floppy. 

floppy interface. 

flush a stream. 

fmt: simple text folmatier. 4 
fold: fold long lines for finite width euiput 

fold long lines for finite width output device. 
font formats for the Benson-Varian or Versatec. 
fonts. vfontinfo: ..... ; 
fopen, freopen, fdopen: open a retream 
for, case, if, while, :, ., break, 
foreach: loop over list of names. 
foreground. ....... 

fork: spawn new process. 

form error log. 
format. 
format. 
format. 
format disks. 
format: how to Faria jae 
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Permured Index 


hier (7) 
quot(8) 
restor (8) 
icheck (8) 
mtab (5) 
Aisys(5) 
utime(2) 
uusend(1C) 
file (1) 
vipw(8) 
basename/1) 
esh(1) 
ferror(3S) 
checknr(1) 
cmp(1) 
comm (1) 
config (8) 
find(1) 
intro(4) 
mpx(2) 


. mvii) 


rm(1) 
sort(]) 
compact(1) 
catman(8) 
dumpdir (8) 
netcp(1) 
badsect(8) 
sucky (8) 
fstab (5) 
fAilsys(5) 
more(]) 
colert(1) 
col(1) 
plot(1G) 
refer(1) 
And(!) 
find (1) 
iook (1) 
man(1) 
ttyname (3) 
lorder(1) 
spell (1) 
strings (1) 
finger (1) 
fold(1) 
head (1) 
dbm(3x) 
fish (6) 
fish (6) 
nice (1) 
tee (1) 
fi(4) 
filsys(S) 
arff(8) 
floor (3M) 
floor(3M) 
arft (8) 
fi(4) 
fclose (3S) 
fmc(1) 
fold (1) 
fold (1) 
vfont(5) 
vfontinfo(1) 
fopen(3S) 
shi) 
esh(1) 
esh(1) 
fork (2) 
dmesg (8) 
ar(3) 

arcv (8) 
dump(5) 
format(8) 
format(s) 


Permuted Index 


uuencode: 

dir: 

filsys, fibik, ino 
core: 

tbl: 

tp: DEC/mag tape 
vront: font 

scanf, fscanf, sscanf: 
printf, fprint!, sprintf: 
fmt: simple text 

troff, nroff: text 

ms: macros for 

me: macros for 
getarg, !argc: command arguments to 
(77: 

ratfor: rational 

efl: Extended 

struct: structure 


adage. 
ching, 
exit, export,/ sh, for, case, if, while, 
printf, 
putc, putchar, 
puts, 


liszt: compile a 


df: disk 

malloc, 

fopen, 

exponent. 

biff: be notified if mail arrives and who it is 
from: who is my mail 

scant, 

mklost+ found: make a lost +found directory for 
repair. 


Stai, 

fseek, 

time, 

chfn: change 

gamma: log gamma 

fabs. floor, ceil: absolute value. floor, ceiling 
intro: introduction to library 

jO, il, jn, yO, vi, yn: bessel 

COS, tan. aSin, acos, atan, atan2: trigonometric 
sinh, cosh, tanh: hyperbolic 
curses: screen 

fread, 

aardvark: yet another exploration 
adventure: an exploration 
backgammon: the 

monop: Monopoly 

snake, snscore: display chase 

trek: trekkie 

worm: Play the growing worm 
cribbage: the card 

hangman: Computer version of the 
oogglie: play the 

chess: the 

zork: the 

wump: the 

gamma: log 


ecyt, fevt, 

abort: 

makekey: 

ncheck: 

rand, srand: random number 
lex: 

from stream. 

Stream. getc, 

getuid, getgid, geteuid, 


getuid, getgid. 


format of an encoded uuencode file. 

format of directories. : 

format of fle system volume. 

format of memory image file. . . 

format tables for nroff or troff. | 

formats. sx bs 
formats for the Benson: Varia: or > Versace. 
formatted input conversion. 

formatted output conversion. 

formatter. .. Be a ve. 

formatting and typesetting. or 

formatting manuscripts. ....... 
formatting papers. Ss Ye dt’ he Be aby aE 
Fortran. ... dar Hgs vty cae de se cas 
Fortran 77 compiler Bde are Lied 
Fortran dialect. a eae ee 

Fortran Language. 

Fortran programs. ; 
fortune: print a random, hopefully interssiing. 
fortune: the book of changes and other cooxies. 
, «, break, continue, cd, eval, exec, ..... 
fprintf, sprintf: formatted output conversion. 
fputc, putw: put character or word on a stream. 
fputs: pul a string on a stream. ge gr tats 
Franz Lisp program. ..... 2.20 « es eee 
fread, fwrite: buffered binary input/output. . . 
free. Dt neon. Maye eneee: & ps a 
free, realloc, calloc: main memory allocator. : 
freopen, fdopen: open a stream. ; 

frexp, Idexp, modf: split into mantissa aad 

PROUT. te dba Se te =e. cal at, Be oD : 

from ?. eA aria ah ios eee 
fscanf, sscanf: fotmatied input conversion. 

fsck. Pad. dee eke ot res Ak Be OP ke cee 
fsck: file system consistency check and interactive 
fseek, ftell, rewind: reposition a stream. ptt ale 
fstab: static information about the filesystems. 
fstat: get file status. ‘he jee. Ep ee tee 0s 8 
ftell, rewind: reposition a stream. a er eee 
flume: get date and time. ...... 

full name of user. de aah ee a wie: we Wh Gav 
function. BOM MO gen ah. cee, Bee a 
fUNCHONS:. -% sono hoe al Bee oes 
fUACIIONS.« +. 4. 6 ee ee, ES SE 


PUAICUONS: ds -2 Sie BR A We aS 
ee, ety eaten ed ae 
functions. Phe, ton wk, Be Me loa cah Be at 


functions with * “eotimal’” cursor motion. ... 
fwrite: buffered binary input/output. ...... 
CATE... 3e.e wide wh oe er ed a Ae 
BATES ces ck. Wi dS Ds ee ee OS 
BAM. inves a, ee Se Be ee a 

CAMO s oh es oh ks Sy i ie a et 


Rate: 4. Bid, & do Wwe eo EO a 
Came: 5 kee ee ee oe SES S 
game. so et cae Mie Ta Sat St “tes Peat sD A hed 
game eabbage:. Bacay ibe oe he > Se 

game hangman. a Be ca eco “ee Gee ke ea 
game ol DORSIE: wwe Saw SB Swe we a Ss 
BAM@ OF CHESS: ao we ee Sh 

game of dungeon. ........ 

game of hunt-the-wumpus. 48 lec.2a, Ss 

gamma function. ... BS -de foe by Gl eh 
gamma: log gamma function. yo: WS aS 
gcv(: output conversion. eH Sb Rte eg 
geneéeraté afault. .-2 . Aw 24 @ 
gencraté encryption key. erat Ao. 4 

generate names from i-aumbers. Sie Ney Jah ie se 
SOREIAIOL... .u. fe S40 3-4 SU ek. Sow SAB 


generator of lexical analysis programs. 

getarg, iargc: command arguments to Fortran. 
getc, getchar, fgetc, getw: get character or word 
getchar, fgetc, getw: get character or word from 
getegid: get user and group identity. gate ge te, 
getenv: value for environment name. 

geleuid, getegid: get user and group identity. 
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uuencode (5) 
dir(S) 

filsys(5) 

core (5) 

tbi(1) 

tp(5) 

vfont(5) 
scanf(3S) 
printf(3S) 
frnt(1) 

troff(1) 

ms(7) 

me(7) 

getarg (3f) 
{77(1) 
ratfor(1) 

efl(1) 

struct (1) 
fortune (6) 
ching (6) 

sh(1) 

printf (3S) 
putc(3S$) 
puts(3S) 

liszt (1) 

fread (3S) 
df(1) 

malloc (3) 
fopen(3S) 
frexp(3) 
biff(1) 
from(1) 

scanf (3S) 
mklost + found (8) 
fsck (8) 
fseek (3S) 
fstab(5) 
stat(2) 
fseek (3S) 
time (2) 
chfn(1) 
gamma(3M) 
floor (3M) 
intro(3) 
j0(3M) 
sin(3M) 
sinh(3M) 
curses (3) 
fread (3S) 
aardvark (6) 
adventure (6) 
backgammon (6) 
monop(6) 


. snake (6) 


trek (6) 
worm (6) 
cribbage (6) 
hangman (6) 
boggle (6) 
chess (6) 
zork (6) 
wump(6) 
gamma (3M) 
gamma(3M) 
ecvt(3) 
abort (3) 
makekey (8) 
ncheck (8) 
rand(3) 

lex (1) 

getarg (3f) 
geic(3S) 
getc(3S) 
getuid(2) 
getenv (3) 
getuid(2) 


get file system descriptor file entry. 
descriptor file entry. getfsent, getfsspec, 
system descriptor file entry. getfsent, 
identity. getuid, 

get group file entry. 

file entry. getgrent, 

getgrent, getgrgid, 


setpgsrp, 


get password file entry. 
entry. getpwent, getpwuid, 
password file entry. getpwent, 


group identity. 

getc, getchar, fgetc, 

vadvise: 

head: 

shutdown: close down the system ata 


ASCII. ctirne, localtime, 
fish: play 
seymp, longjmp: non-local 


graph: draw a 


plot: 

greek: 

plot: openpl et al.: 
plot: 


vgrind: 

chown, chgrp: change owner or 

Killpg: send signal to a process or a process 
newgrp: log in to a new 

setperp, getpgrp: set/get process 

group: 

getergid, getgrnam, setgrent, endgrent: get 


setuid, setgid: set user and 

getuid, getgid, geteuid, getegid: get user and 
chown: change owner and 

make: maintain program 

worm: Play the 

ioctl, stty, 

Stop: 

reboot: reboot system or 


re_comp, re_exec: regular expression 
hangman: Computer version of the game 


vhangup: virtually 

nohup: run command immune to 
crash: what 

uptime: show how long system 
see: see what a file 

rehash: recompute command 
unhash: discard command 
hashstat: print command 


leave: remind you when you 


hier: file system 
wtmp: user login 
history: print 


fortune: print a random, 
uusend: send a file to a remote 
uptime: show 

format: 


getfsent, getfsspec, getfsfile, setfsent, endfsent: 
getfsfile, setfsent, endfsent: get file system 
getfsspec, getfsfile, setfsent, endfsent: get file 
getgid, geteuid, getégid: get user and group 


getgrent, getgrgid. getgrnam, setgrent, endgrent: 
getgrgid, geigrnam, setgrent, endgrent: get group 
geigrnam, setgrent, endgrent: get group file entry. 


getlogin: get login name. 
getpass: read a password. 


getpgrp: set/get process group. ..... is Ze ee 


getpid: get process identification. .... .~. 
getpw: get name from uid. 


getpwent, getpwuid, getpwnam, setpwent, “endpwent: 
getpwnam, setpwent, endpwent: get password file 


getpwuid, getpwnam, setpwent, endpwent: get 
gets, fgets: get a string from a stream. 
gets: get a string from standard lua 
getty: set terminal mode. ms 
getuid, getgid, geteuid, getegid: get user ‘and 
getw: get character or word from stream. 
give advice to paging system. 
give first few lines. 
given time. ......6. 
glob: filename expand argument list. 


"AGO FISK. &. G04 eee a 
goto. ... 
goto: command transfer. 
READNCA ha, Ge eG ca es dat ee Sed 
graph: draw a graph. ie 

graphics filters. ...... 

graphics for extended TTY-37 type- box. 
graphics interface. of 1 Ge 
graphics interface. 


greek: graphics for extended FIV aynee or 


grep, egrep, fgrep: search a file for a pattern. 


grind nice listings of programs. ...... 


QIOUG. nee 4 ee OK 


e @® 8© © @® 8 «6 


group. ol Ge a see Sy ae 


BOUND TO. o. e gorks Se Se eo wa SS oid chy’ Zoe, 8 A 
group file entry. getgrent, ........ 


group: group file war 
STOUD ID) oc oe a ae 
group identity; «<< 43 2.6 ee & % iS ao 
group Of ales <6 «Wie @ ws 


growing worm game. 


halt a job or process. 
halt processor. ...... 


PAMIGIOKS sh -48 se ti Gor We AR. Ga ae fae OB 
NaneMan... cee ew Al eS 


‘‘hangup’ the current control terminal. 
FaTRUOS.. ke ce eK 
happens when the system crashes. 

Mas: Deen UD: a & . al e-aG eid! & Me ay eae 
MASH oe we i ee eh gcste cae ae che 3 


hash table. ......+24-.- Mot > te Arik, dd ; 


Hashtapiee!  ke cee, hs es: as: SH SE: BS 
hashing statistics. 


hier: file system hierarchy. 


WIStOOVs | oc iw fa ao Se EE ee Se 


HiStOrv G@VERE St. ena ere ee ee ee Se ae eA 
history: print history event list.  . . ......-s 


hk: RK6-11/RK06 and RKO7 moving head disk. 
hopefully interesting, adage. ........ 
NOSts ooan Ae a ere SO OsEL LS Bees 


- XXXV - 
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gmtime, asctime, timezone: convert date and time to 
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SfOUDS. «wo Glew wee oe ce A Bee es 


gtty. COMUTOL GEVICE. 6, en ewe ee Ae ee 
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halt: stop the processor. . . . 2... 2 2 ee we ew 
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hangman: Computer version of the game hangman. 
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hashstat: print command hashing statistics. mo i Be 
RavetG 1léaves! 4 a. ee Ss eS ee a 
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how long system has beenup. .......6.6.-. 
how to-format disks. «2 ¢ @ 4 ea A 4 aoe aS 
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getfsent(3) 
getfsent(3) 
getfsent(3) 
getuid(2) 
getgrent(3) 
getgrent(3} 
getgrent(3) 
getlogin(3) 
getpass (3) 
setpgrp(2)) 
getpid (2) 
getpw(3) 
getpwent(3) 
getpwent(3) 
getpwent(3) 
gets(3S) 
gets(1) 
getty (8) 
getuid(2) 
getc(3S) 
vadvise (2v) 
head(1) 
shutdown (8) 
esh(1) 
ctime (3) 
fish (6) 
setimp (3) 
esh(]) 
graph(1G) 
graph(1G) 
plot(1G) 
greek (7) 
plot(3x) 
plor(S) 
greek (7) 
grep(1) 
verind(]) 
chown(8) 
killpg (2)) 
newgrp(1) 
setpgrp(2)) 
group(5) 
getgrent(3) 
group(5) 
setuid (2) 
getuid(2) 
chown (2) 
make (1) 
worrn (6) 
ioctl (2) 
esh() 
reboot(2v) 
halt (8) 
regex (3) 
hangman (6) 
hangman(6) 
vhangup(2v) 
esh(1) 
crash (8) 
uptime (1) 
see (1) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
leave(]) 
hier (7) 

hier (7) 
wtmp(5) 
esh(1) 
esh(1) 

hk (4) 
fortune (6) 
uusend(1C) 
uptime (1) 
format (8) 
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moving-heed disk. 
interface. 

wump: the game of 
sinh, cosh, tanh: 


getarg, 


setuid, setgid: set user and group 

whoami: print effective current user 

Su: substitute user 

getpid: get process 

getgid, geteuid, getegid: get user and group 


bill: be notified 

eval, exec, exit, export, login,/ sh, for, case, 
signal: catch or 

SigsyS: catch or 

core: format of memory 

notify: request 

nohup: run command 

xsir: extract strings from C programs to 

eyacc: modified yacc allowing much 

which: locate a program ile 

dump, ddate: 

dump: 

restor: 

tgetnum, tgetflag, tgetsir, (goto, tputs: terminal 
ptx: permuted 

strncat, strcmp, strncmp, strcpy, strncpy, sirlen, 
iast: 

syscall: 

bad144: read/write dec standard 144 bad sector 
Vpac: print raster printer/ploter accounting 
vires: get 

fstab: static 

vfontinfo: inspect and print out 

man: find manual 

finger: user 


init: process control 

ttys: terminal 

popen, pciose: 

filsys, fibik, 

ciri: clear 

gets: get a string from standard 
soelim: eliminate .so's from nroff 
scant, fscanf, sscanf: formatied 
ungetc: push character back into 
fread, fwrite: buffered binary 

stdio: standard buffered 

feof, ferror, clearerr, leno: stream status 
refer, lookbib: find and 

vfontunfo: 

learn: computer aided 

ltol3: convert between 3-byte integers and long 
doctor: 

fsck: fle system consistency check and 
fortune: print a random, hopefully 
cons: VAX-I1 console 

ct: phototypesetter 

fl: floppy 

ht: TM-03/TE-16,TU-45,TU-77 MASSBUS magtape 
mt: UNIX magtape 

plot: openpl et al.: graphics 

plot: graphics 

rv: Racal/Vadic ACU 

tm: TM-11/TE-10 magtape 

ts: TS-11 magtape 

tty: general terminal 

va: Benson- Varian 

vp: Versatec 

vswapon: add a swap device for 
spline: 

apl: an apl 

lisp: lisp 

pti: phototypesetier 


hp: RPO6, RMO3, RMO05, RM80, RPO7 MASSBUS 
he: TM-03/TE-16,TU-45,TU-77 MASSBUS magtape 
hunt-the-wumpus. iP, A hs a a eels : 
hyperbolic functions. ... : 

hypot, cabs: Euclidean distance: ; 

iargc: command arguments to Fortran. 

icheck: file system storage consistency check. 

IDs <a Meet Sa eu 2 F 

id. ? - 2 

id ‘emporanily. 

identification. 

identity. getuid, 

if: conditional slatemment: 

if mail arrives and who it is fiom: 

if, while, :, ., break, continue, cd, 

ignore signals. 

ignore signals. 

image Mle. : 

immediate notification: : 

immune to hangups. ..... 

implement shared strings. 

improved error recovery. 

including aliases and paths gh éniy): 

incremental dump format. 
incremental file system dump. 
incremental file system restore. 
independent operation routines. 
index. 4s ; 
index, rindex: string aperations. strcat, 
indicate last logins of users and teletypes. 
indirect system call. ae ee ee 
information. 
information. 
information about resource eilization: 
information about the flesystems. 

information about unix fonts. 

information by keywords: print out the manele 


tgetent, 


eo 2 &® ® e e oe @ 


information lookup program. Ze Mk ane Si, der ES, Hage BT ee 
init: process control iniualizauon. 

Immiahzauon. . . . «6. 

inuuialization data. M; ee S. ty 


initiate 1/O to/from a process. 

ino: format of file system volume. 
i-node. 
input. .. 
inpul. 
input conversion. 

input stream. “ 
input/output. 6 shee sees 
input/output nach ace: ane 
inquiries. ... 
insert literature references in documents. . 
inspect and print out information about unix fonts. 
instruction about UNIX. ae ee 
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integers. I3tol, ..... i ok 
interact with a psychoanalyst. 
inferactive repair. Be vake.maY ete ae aos 


interesting, adage. 

interface. i 

interface. 

interface. ... 

interface. SM a eS 

INCELACE.. a de ea ee es a Ee BS 
interface. 
interface. 
interface. 
interface. a er eo ee 
interface. i la: Ket ae ve Oe 
interface. 
interface. 
interface. 
interleaved paging/ swapping. 
interpolate smooth curve. 
interpreter. 
interpreter. 
interpreter. Boi dan tose 2 
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hp(4) 
hte(4) 
wump(6) 
sinh(3M) 
hypot(3M) 
getarg (3f) 
icheck (8) 
setuid (2) 
whoami(1) 
su(]) 
getpid (2) 
getuid (2) 
csh(1) 
biff (1) 
sh(l) 
signal (2) 
sigsys (2j) 
core (5) 
esh(1) 
esh(1) 
xstr(1) 
eyacc(1) 
which(1) 
dump(5) 
dump (8) 
restor (8) 
termcap(3) 
ptx (1) 
string (3) 
last (1) 
syscall (2) 
bad 144(8) 
vpac (8) 
viimes (2v) 
fstab(5) 
vfonunfo(]) 
man(1) 
finger (1) 
init(8) 
init(8) 
itys(5) 
popen (35) 
filsys(5) 
ciri(8) 
gets(1) 
soelim (1) 
scanf (3S) 
ungetc(3S) 
fread(3S) 
sidio (3S) 
ferror (3S) 
refer(1) 
vfontinfo(1) 
learn(1) 
Istol (3) 
doctor(6) 
fsck (8) 
fortune (6) 
cons (4) 
c1(4) 

fl(4) 

ht(4) 
mt(4) 

plot (3x) 
plot (5) 
rv(4) 

tm (4) 

ts (4) 

tty (4) 
va(4) 
vp(4) 
vswapon(2v) 
spline (1G) 
apl(1) 

lisp (1) 

pu 1) 


peeing, 


nohup: run 

csh: a shell 

whatis: describe what a 
readonly, set, shift, times, trap, umask, wait: 
net: execute a 

repeat: execute 

rc: 

onintr: process interrupts in 
goto: 

else: alternative 

intro: introduction to 

at: execute 

apropos: locate 

while: repeat 

lastcomm: show last 
source: read 

comm: select or reject lines 
bk: line discipline for machine-machine 
dh/dm: DH-11/DM-11. 

dz: DZ-11 

users: 

files, and cat them. 

diff: differential file and directory 
cmp: 

diff3: 3-way differential file 
uudiff: directory 

liszt: 

ecnC 

(77: Fortran 77 

pe: Pascal 

error: analyze and disperse 
yacc: yet another 

wait: wait for background processes to 
wait: awail 

compact, uncompact, ccat: 
learn: 

hangman: 

test: 

endif: terminate 

if: 

while: repeat commands 


config: Build system 


dcheck: file system directory 

icheck: file system storage 

fsck: file system 

cons: VAX-1] 

show what versions of object modules were used to 
| mkfs: 

deroff: remove nroff, troff, tbl and eqn 
vlimit: control maximum system resource 
badsect: create files to 

is: list 

netq: print 

sh, for, case, if, while, :, ., break, 


ioctl, sity, gtty: 

jobs: summary of job 

init: process 

viimit: 

vhangup: virtually “hangup the current 
up: unibus storage module 

‘terminals: 

ecvt, fevt, gevt: output 

printf, fprintf, sprintf: formatted output 

scanf, fscarf, sscanf: formatted input 

units: 

dd: 

number: 

arcy: 

ranlib: 

atof, atoi, atol: 

I3tol, ltol3: 

ctime, localtime, gmlime, asctime, umezone: 

bed: 


9% 4 


command immune to hangups. a 

(command interpreter) with C-like re 
command ts. ei Se BOA Be Be ek, Be Be So a we 
command language. Jexpoit. login, newerp, read, 
command on aremote machine. .....4.2.. 
command repeatedly. ...... é 
command script for auto-reboot and daemons: 
command scripts. ade oe Ht Gy Fa cde ee ee 
command transfer. ........24.e48.6 
commands. eae ae ee ee” ay ee 
commands. « ¢ «4244 2<4 6% «%4 
commands at a later time. S, cia as rae ee SS or 
commands oy keyword lookup. © ie 3S Oe os ene 
commands conditionally. .......4.. 
commands executed in reverse order. belies we 
commands from fle. ...... 
common to two sorted files. . . 
communication. ..... 
communications multiplexer. 
communications multiplexer. 
compact list of users who are on the system. i 
compact, uncompact, ccat: compress and uncornpress 
COMparatOr.:. citi nat Bh ce ee Ge we eres he 
compare two files. .. 0.0.0.0. .600804 
COMPSIISOR.. <2 6s Sr eS ee Soa es 
comparison between machines. Gis dah ta ie, es ae 
compile a Franz Lisp program. Ryai ae. ee Bh cd 
COMIGNGE:. 2. ote 4s de os Ses me He ew 
COMIDIET.. 65-5 Bees eS A ae 
COMICNEE: 64 arta: Se SR Ae, SS we 
compiler error messages. ......4.. 
comptler-compiler, . 2... 2 6 6 ew ew ee 
COMIDIGIE. 6. oo a we a SO a we a ; 
completion of process. hoe Wane as es ce. oly wee 
compress and uncompress files, and cat sheen: ae 
computer aided instruction about UNIX. ..... 
Computer version of the game hangman. ..... 
condition command. .......2-.ee08 
CONGINIOGA. i 40 EW oe SE. Ha 
conditional statement. Se Witte, Bode te oe: Se dees ee 
conditionally. Sie ed Sd es He ee ecid, 
config: Build system configuration files ...... 
configuration files, 2... 6. 0 0 ee ee ee 
cons: VAX-!1 console interface. .....2.2.2.. 
consistency check. .... 6 ee ee we we wwe 
consistency check: 2. 44.4454 # & Gd ww a 
consistency check and interactive repair. eat ae 
console interface. Bh acti adh Aa. Gi, a a Sk Abs aR” Yor Yas oat 
construct a file. what: bo a ee ste, ne ee She 
construct a file system. . . 2... 0. 2 0 we ew 


@ 


constructs. e es 6 8 2 oe & & 4 @ @ @ G @ & aw 9 9 
consumption. St a HONS sae a ee Je OB. Gatcta eR ee eet 
contain bad sectors. D. 2g iS i, tem Ponce Ee ea 


contents of directory. . . . 6 2 ee ee ew ew ew 
contents of network queue. . 2... 0.0.0.6. ee ee 
continue, cd, eval, exec, exit, export, login,/ 
continue: cycle in loop. ... 2... +5 6 «se os 
CONTTOL-GEVICE. 4 os ee fe Ka AS ew. PA we Se 
control facilities. . 2... 2. 6 1 © ee ew ew te we 
control initialization, . 2. 2. 2 1 8 ee te ew we 
control maximum system resource consumption. 
control terminal. . .... » 4 eg : 
controller/drives. eal Oe. ee ee 
conventional names. . .. 6. 6 6 2 © ee ew ew 
CORVETSION» © 5) ew Se ek BR ee Se we 
CONVEISION:,.§ 0): 2 ho ee ew Sn Bw A 
CONVErSION: 4 we 6 A: Rw we HO eS aK 
conversion program. . . . 6 6 6 © « ee we 
convert and copya file. ..... : on 
convert Arabic numerals to Engli STs a, ate a atoh. 
convert archives to new format. . . 2... 6 6 2 
convert archives to random libraries. . ... . 
convert ASCI] to numbers, . . 0... ee 
convert between J-byte integers and long integers. 
convert date and time to ASCID. . . 1. 1. we 
convert to antique media. . 1. 1. 6 6 6 0 ee we 
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esh()) 
esh(1) 
whatis(1) 
sh(1) 
net(1) 
esh(1) 
re(8) 
csh(1) 
esh(1) 
esh(1) 
intro (1) 
at(1) 
apropos(1) 
esh(1) 
lastcomm (1) 
esh(1) 
comm (1) 
bk (4) 

dh (4) 
dz(4) 
users(]) 
compact(1) 
diff(1) 
emp(1) 
diff3 (1) 
uudiff(ic) 
liszt(1) 
ec(1) 
770) 
pc(1) 
error(1) 
yace(]) 
esh(1) 
wait() 
compact (1) 
learn(1) 
hangman (6) 
test (1) 
esh(1) 
esh(1) 
esh(1) 
config (8) 
config (8) 
cons (4) 
dcheck (8) 
icheck (8) 
fsck (8) 
cons (4) 
what(1) 
mkfs (8) 
deroff(]) 
viimit(2v) 
badsect (8) 
Is() 
netq(]) 
sh(1) 
esh(1) 
joctl(2) 
jobs (3)) 
imit(8) 
viimit (2v) 
vhangup(2v) 
up (4) 
term(7) 


dd ¢ DD 
number (6) 
arcv (8) 
ranlib(1) 
atof(3) 
I3tol (3) 
ctime (3) 
bed (6) 
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ching, fortune: the book of changes and other 
arff, flcopy: archiver and 

. cp: 

uucp, uulog: unix to unix 

dd: convert and 

netcp: remote 

brk, sbrk, break: change 

savecore: save a 


functions. sin, 
sinh, 

we: word 

sum: sum and 


analyze: Virtual UNIX postmortem 
crash: what happens when the system 


creat: 

ctags: 

mikstr: 

pipe: 

mpx: 

badsect: 

catman: 

umask: change or display file 
umask: set file 

cribbage: the card game 


ixref: lisp 

pxref: Pascal 

colcrt: filter nroff output for 
more, page: file perusal filter for 


syntax. 
newcesh: description of new 


convert date and time to ASCII. 


vhangup: virtually ‘*hangup”’ the 

jobs: print 

whoami: print effective 

chdir: change 

motion. 

curses: screen functions with ‘‘optimal”’ 
spline: interpolate smooth 

continue: 

cron: clock 

re: command script for auto-reboot and 
eval: re-evaluate shell 

prof: display profile 

ttys: terminal initialization 

termecap: terminal capability 

newaliases: rebuild the 

ttytype: 

dbminit, fetch, store, delete, firstkey, nextkey: 
null: 

types: primitive system 

join: relational 

date: print and set the 

time, ftime: get 

localtime, gmtime, asctime, timezone: convert 
touch: update 


data base subroutines. 


dump, 

adb: 

sdb: symbolic 

bad 144: read/write 
tp: 


cookies. 
copier for floppy. 
cOpy. .. 
CODY.» --o ee 4@-% 
copy a file. 
copy of files through the net. 
core allocation. 
core dump of the operating system. 
core: format of memory image file. 
cos, tan, aSin, acos, atan, atan2: trigonometric 
cosh, tanh: hyperbolic functions. 
count. 
count blocks in a file. 
cp. Copy. 
crash analyzer. 
crash: what happens when the system crashes. 
crashes. 
creat: create a new file. 
create a new file. 
create a tags file. 
create an error message file by massaging C source. 
create an interprocess channel. 
create and manipulate multiplexed files 
create files to contain bad sectors. 
create the cat files for the manual. 
creation mask. ... 
creation mode mask. .... . 
cribbage. Ne: dor ta 
cribbage: the card game cribbage. 
cron: clock daemon. Eee Se 
cross reference program. 
cross-reference program. 
CRT previewing. 
crt viewing. 
crypt: encode/decode. 
crypt, setkey, encrypt: DES encryption. 
esh: a shell (command interpreter) with C-like 
esh features (over oldesh). 
ct: phototypesetter interface. 
ctags: create a tags file. 
ctime, localtime, gmtime, asctime, timezone: 
culcall UNIAS. 4.5 Sas 
current control terminal. bo hee 
current job list. 
current user id. 
current working directory. 
curses: screen functions with ‘“‘optimal’’ cursor 
cursor mouon. . . 6 2 « © wo 
curve. 
cycie in loop. 
daemon. 
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data base. . 
data base for the mail aliases file. 
data base of terminal types by port. 
data base subroutines. 
data sink. 
data types. 
database operator. . 
date. 
date and time. 
date and time to ASCII. ctime, 
date last modified of a file. 
date: print and set the date. 
dbminit, fetch, store, delete, firstkey, nexikey: 2b, ead 
de: desk calculator. 
dcheck: file system directory consistency check. 
dd: convert and copy a fle. 
ddate: incremental dump format. 
debugger. 
GOOURCOC. ee ea eta ha Ses SS we PS 
dec standard 144 bad sector information. 
DEC/mag tape formats. 
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arft(8) 


savecore (8) 
core (5) 

gin (3M) 
sinh(3M) 
we (1) 

sum (1) 

cp (1) 
analyze(8) 
crash (8) 
crash(8) 
creat (2) 
creat(2) 
ctags(1) 
mkstr (1) 
pipe (2) 
mpx (2) 
badsect (8) 
catman(8) 
esh(1) 
umask (2) 
cribbage (6) 
cribbage (6) 
cron(8) 
Ixref(1) 
pxref(1) 
colert(1) 
more (1) 
crypt(1) 
crypt(3) 
esh(]) 
newcesh (1) 
ct(4) | 
ctags ( 1 ) eee 
ctime (3) 
cu(ic) 
vhangup(2v) 
esh(1) 
whoami(1) 
chdir(2) 
curses (3) 
curses (3) 
spline (1G) 
esh(1) 
cron(8) 
re(8) 

esh(1) 
prof(1) 
ttys(5) 
termcap(5) 
newaliases(1) 
ttytype (5) 
dbm (3x) 
null (4) 
types (5) 
join(]) 

date (1) 

time (2) 
cume (3) 
touch (1) 
date (1) 

dbm (3x) 
de(1) 

dcheck (8) 


tp(5) 


apropos: locate commands by keyword 
finger: user information 

break: exn while/foreach 

continue: cycle in 

end: terminate 

foreach: 

library. 

mklost+found: make a 


lpr, Iprm, 


Ipr, 


integers. |3tol, 


net: execute a command on a remote 

provide login name and password for a remote 
netmail: read mail on a remote 

bk: line discipline for 

uudiff: directory comparison between 

m4: 

alias: shell 

translate version 6 manual macros to version 7 
ms: 

me: 

| mani: 

iran: translate version 6 manual 


mt: 

ht: TM-03/TE-16,TU-45,TU-77 MASSBUS 
mt: UNIX 

tm: TM-lL1/TE-10 

~ ts: TS-1] 

mail: send and receive 

encode/decode a binary file for tranmission via 
xsend, xget. enroll: secret 

newaliases: rebuild the data base for the 
mail: send or receive 

biff: be notified if 

from? who is my 

prmail: print out 

mail: pseudo-device for 

netmail: read 

msgs: system messages and junk 


delivermail: deliver 

mem, kmem: 

malloc, free, realloc, calloc: 
make: 

ar: archive and library 
mkdir: 

mknod: 

mklost+found: 

mktemp: 

In: 


Script: 


allocator. 
the manual. 


signal, sighold, sigignore, sigrelse, sigpause: 
shift: 

mpx: create and 

tp: 

mt: magnetic tape 

frexp, Idexp, modf: split into 

catman: create the cat files for the 

find manual information by keywords, print out the 
man: macros to typeset 

whereis: locate source, binary, and or 
manual. man: find 

irman: translate version 6 


lookup. , 

lookup program. 

loop. Be Ser Maks ihe oa) Se SRS ok Se, See 

HOODS... « foes 4) Gee se we ee 

loop. .. eae 

loop over list of n names. ; 

lorder: find ordering relation for an object 
lost+found directory for fsck. 

Ip: line printer. ; , 

Ipq, print: line printer epoolee. 

lpr, Iprm, Ipq, print: line printer spooler. 

Iprm, Ipq, print: line printer spooler. 

is: list contents of directory. 

Iseek, tell: move read/write pointer. a 
Itol3: convert between 3-byte integers and long 
Ixref: lisp cross reference program.. 

m4: macro processor. 
machine. .. 

machine. netlogin: 
machine over the network. 
machine-machine communication. 
machines. ...... 

macro processor. 

macros. 

macros. trman: : 

macros for formatting manuscripts. 
macros for formatting papers. 

macros to typeset manual. 

macros to version 7 macros. , 
magnetic tape manipulating program. 
magtape interface. ....... 
magtape interface. 

maygtape interface. 

magtape interface. 

mail. 
mail. 
mail oo. . 
mail aliases file 

mail among users. 

mail arrives and who it ts from. 

mail from”. ; 

mail in the post office. 

mail notification. . 

mail on a remote machine over the Adiwack: 

mail program. . ee er 
mail: pseudo-device for mail ‘notification. 

mail: send and receive mail. 

mail: send or receive mail among users. 


e % ° 


uuencode uudecode: 


mail to arbitrary people. ae ee ee 
main memory. ...... 3. 2s a 
main memory allocator. ge ae 84 Pe Xe 
maintain program groups. 

maintainer. : 


make a directory. 

make a directory or a spécial file. 

make a lost+found directory for fsck. 

make a unique file name. 

make links. é 3. 

make: maintain program groups. aie a 

make typescript of terminal session. —, 

makekey: generate encryption key. 

malloc, free, realloc, calloc: main memory 

man: find manual information by keywords, ririte out 
man: macros to typeset manual. 

manage signals. sigset, - 

manipulate argument list. 

manipulate multiplexed files. 

manipulate tape archive. 

manipulating program. 

mantissa and exponent. 

manual. . 2:46. 4 «+ 

manual. man: 
Manual: 2:<e wee He Siw SS 

manual for program. 

manual information by keywords: print ul the 
manual macros to version / macros. 
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apropos(1) 
finger (1) 
esh(1) 
csh(1) 
esh(1) 
esh(1) 
lorder(1) 
mklost + found (8) 
Ip (4) 
Ipr(1) 
Ipr(1) 

Ipr (1) 

Is(1) 

Iseek (2) 
I3tol(3) 
Ixref(]) 
m4(1) 
net(]) 
netlogin(1) 
netmail(1) 
bk (4) 
uudiff(1C) 
m4(1) 
esh(1) 
trman(1) 
ms(7) 
me(7) 
man(7) 
trman(1) 
mt(1) 
ht(4) 
mt(4) 

tm (4) 

ts (4) 
miatl(]) 
uuencode(1C) 
xsend (1) 
newaliases(]) 
binmiail (1) 
biff (i) 
from(]) 
prmail(1) 
mail (4) 
netmaitl (1) 
msgs (1) 
mail (4) 
mail(1) 
binmail (1) 
delivermail (8) 
mem (4) 
malloc (3) 
make(1) 
arti) 
mkdir (1) 
mknod (2) 
mklost + found (8) 
mktemp(3) 
In(1) 
make(1) 
script(1) 
makekey (8) 
malloc (3) 
man (1) 
man(7) 
sigset (3) 
esn(1) 

mpx (2) 
tp(1) 
mt(1) 
frexp(3) 
catman (8) 
man (1) 
man(7) 
whereis(1) 
man(1) 
trman(1) 


Permuted Index 


ms: macros for formatting 

umask: change or display file creation 
umask: set file creation mode 

mkstr: create an error message file by 
ht: TM-03/TE-16,TU-45 ,TU-77 

hp: RP06, RM03, RM0S, RM80, RP0Q7 
eqn, neqn, checkea: typeset 

vlimit: control 


bed: convert to antique 


mem, kmem: main 

malloc, free, realloc, calloc: main 
valloc: aligned 

vfork: spawn new process in a virtual 
core: format of 

vmstat: report virtual 

sort: sort or 

pmerge: pascal file 


mkstr: create an error 

error: analyze and disperse compiler error 
mesg: permit or deny 

perror, syS_errlist, sys_nerr: system error 
msgs: system 

dmesg: collect system diagnostic 

mille: play 


source. 


chmod: change 

getty: set terminal 

umask: set file creation 

chmod: change 

tset: set terminal 

frexp, Idexp, 

touch: update date last 

recovery. eyacc: 

up: unibus storage 

what: show what versions of object 


monop: 


curses: screen functions with ‘‘optimal”’ cursor 
| mount, umount: 
mount, umount: 


mitab: 

mv: 

Iseek, tell: 

hk: RK6-11/RK06 and RKO7 

hp: RP06, RM0O3, RM05, RM80, RPO7 MASSBUS 


eyacc: modified yacc allowing 

mpx: create and manipulate 

mpxio: 

dh/dm: DH-11/DM-11 communications 
dz: DZ-11 communications 

switch: 


from: who is 
getenv: value for environment 
getiogin: get login 


MASK “GS so Bes oe. Bs es es Se & 4S ae 
NAS Kc. Ais te wae we ee ak a em Oe a de Te es Es 
massaging C source. 
MASSBUS magtape interface. .....2.2.2..e8-. 
MASSBUS moving-head disk. ........2..064 
mathematics. 
maximum system resource consumption. ....... 
me: macros for formatting papers. ......2.2.2.2.. 
FGCIR ge oe 06S Ug ea ee a, Ge ee Ee ee RA 
mem, kmem: main memory. 
memory. 
memory allocator. 
memory allocator. 
memory efficient way. 
memory image file. 
memory statistics. 
merge files. 
REIGEE:, cec oe hu OP we ees ae es Sc te ee 
mesg: permit or deny messages. .........046-4 
message file by massaging C source. .......2.-. 
messages. .... 2. ee oi beard Batkeees eee 
messages. .....eee ie pie ak. Ys tg ah 46>. dee He se es 
MESSAGES ° sec es Se We SE ar Se Bes ee SS 
messages and junk mail program. ad. ee Hw: a 2 
messages to form error log. . . 2. + 6 ee 2 ee eo 
Mille Bournes. . . . 2. 2. 2. ee oo eee ce eee ee 
mille: play Mille Bournes. ......4..2.0.088e8 
mkdir: make a directory. 
mkfs: construct a file system. 
mklost+found: make a lost+found directory for fsck. . 
mknod: build special fle. . ........00008-8 
mknod: make a directory or a special fle. . ...... 
mkstr: create an error message file by massaging C 
mktemp: make a unique file name. 
MOdG. 9 £206 B-4 eB se Ee ee Se ia Se Ee eS 
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PHOGEMINASK SS. “a5 xa: heo eke GR eee Sa ee SO Ser es 
mode of file. 
PROCES... ge a oH ae SS eG Bee ee es a, BS 
modf: split into mantissa and exponent. 
modified of a file. 
modified yacc allowing much improved error 
module controller/drives. . . 2. 6 « © «© ee we eo 
modules were used to construct a file. 
monitor: prepare execution profile. .......28. 
monop: Monopoly game. . . 1. 2. 1 2 0 ee ee ew 
Moropoly game: :40co ws ew ee a ee 
more, page: file perusal filter for crt viewing. 
THOUION Ge: ce. es ue ew RES vee KS Az ioe Re mip, ah Sera Ga Niey oe 
mount and dismount file system. 
mount or remove file system. .. 2... 2. 2. «© 2 o © 
mount, umount: mount and dismount file system. .. . 
mount, umount: mount or remove file system. 

mounted file system table. 
move or rename files. Ms case ShcA Jay. SE tesa a, cee Ses se Se 
move read/write pointer. . . 2. 6 2 6 2 ee ee ew 
BIOVING NeaG-Gisk.: . 4. a. Gia oe Sa Ea a GO 
moving-head disk. . . 1.1. 2 ee se ee ee we eee es 
mpx: create and manipulate multiplexed files. ..... 
mpxio: multiplexed i/o. . 2... 1 6 ww ew ee tw ew 
ms: macros for formatting manuscripts. 
msgs: system messages and junk mail program. xy 
mt: magnetic tape manipulating program. ....... 
mt: UNIX magtape interface. 
mitab: mounted file system table. 
much improved error recovery. 
multiplexed files. <2 2 22 °G ew aS Be ew 
multiplexed i/o. 
MULNDIOXOL:< So4. co we A Ee a a ee Se we 
MIUILIDICKEF, SoS ace, Boe ee SO ee ow 
multi-way command branch. 
mv: move or rename files. 
my mail from?. dst nel Weel ce ue Wee wae ee. a ee Se a 
mame. ....e.6.-s ee Ne at an eh ey ah ye he os 
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umask (2) 
mkstr(1) 


me(7) 


mem (4) 
malloc (3) 
valloc (3) 
vfork (2v) 
core (5) 
vmstat(1) 
sort(1) 
pmerge(1) 
mesg (1) 
mkstr (1) 
error(1) 


mille (6) 
mkdir (1) 
mkfs(8) 


mklost +found (8) 


mknod (8) 
mknod (2) 
mkstr(1) 


mktemp(3) 


chmod (1) 
getty (8) 
umask (2) 
chmod (2) 
tset(1) 
frexp(3) 
touch (1) 
eyacc(]) 
up (4) 
what(1) 
monitor (3) 
monop (6) 
monop (6) 
more(1) 
curses (3) 
mount(8) 
mount(2) 
mount(8) 
mount(2) 
mtab(5) 
mv (1) 
iseek (2) 
hk (4) 
hp(4) 

mpx (2) 
mpxio(5) 
ms(7) 
msgs (1) 
mt(1) 

mt (4) 
mtab(S) 
eyacc(1) 


getenv (3) 
getlogin (3) 


mktemp: make a unique file 
pwd: working directory 

tty: get terminal 

netlogin: provide login 
getpw: get 

nlist: get entries from 

nm: print 

symorder: rearrange 
ttyname, isatty, ttyslot: find 
chfn: change full 

foreach: loop over list of 
terminals: conventional 
ncheck: generate 

dumpdir: print the 


eqn, 
netcp: remote copy of files through the 
netipr: use a remote lineprinter through the 


file. 
remote machine. 


network. 


network. 

netmail: read mail on a remote machine over the 
nettroff: troff to the phototypesetter over the 
netlog: print the last few lines of the 

netq: print contents of 

netrm: remove a command from the 
newcsh: description of 

creat: create a 

arcv: convert archives to 

newerp: log in toa 

fork: spawn 

vfork: spawn 

newtty: summary of the 

login: login 

adduser: procedure for adding 

aliases file. 

oldcsh). 


/continue, cd, eval, exec, exit, export, login, 


dbminit, fetch, store, delete, firstkey, 

alter priority of running process by changing 
vgerind: grind 

(shonly). 


only). nice, 


setimp, longjmp: 

notify: request immediate 
mail: pseudo-device for mail 
biff: be 


soelim: eliminate .so’s from 
tbi: format tables for 

colert: filter 

trof, 

deroff: rernove 

checknr: check 


arithmetic: provide drill in 

rand, srand: random 

num: 

atof, atoi, atol: convert ASCII to 

errno: introduction to system calls and error 
number: convert Arabic 


name. te oe exetigg cos Sot ee Soca 

name. Stee ie eae Go ES a ee De 

name. B -SeusGr erick, ae eas 
name and nacsword. for a remote achine: ‘ 
name from uid. eae ee 

NAMIC TISt.. Boca hoes Soh Se SE 
FAMVIGHSts, 2 3k Sat ew Mew ee ae Oe 
Namedist;: 424: 5 aia R. @ Soe 4 
name of a terminal. 3. Me 
name of user. .....2.2..6.-. 
MAMeS els Ke SS Soe we 
PAMIGSS ervey ie cee eh A ee eo 
narnes from i-numbers. 

names of files on a dump tape. go adcah det 
ncheck: generate names from i- -numbers. — 
neqn, checkeq: typeset mathematics. ... 
net. ee ae ee ee ae ee 

net. Who ee et Sas “Uo a Ae oe ae ws hs OR gs ee 
net: execute a command on a remote machine. 
netcp: remote. copy of files through the net. 
netlog: print the last few lines of the network log 
netlogin: provide login name and password for a 
netipr: use a remote lineprinter through the net. 
netmail: read mail on a remote machine over the 
netq: print contents of network queue. 


netrm: remove a command from the network queue. 


nettroff: troff to the phototypesetter over the 
network. ae ee ae ae 
network. os wee Se 
network log fle. ........ 
network queue. ret ee Wee Dae 
network queue. ee ee ee Soe a 
new csh features (over oldcsh). ..... 
new file. Be oh Bb tak 4s 
new format. ......... 
new group. ile. Ge sesh) We ao ee 
mew process. . . 1.1.5. es «> Ue sk Sas ee ee 
new process in a virtual memory aAicient en 
“new” tty driver. Be Me as wie ces Sp ge, ee 
NEW USEF.: 2.4 ol Bose wee ew Ses 
new users. B, dpudncec se OR. Gt we at ee We ee eS 
newaliases: rebuild the data base for the mail 
newcsh: description of new csh features (over 
newerp: log in to a new group. ; : : 
newerp, read, readonly, set, shift, nes: (rage 
newtty: summary of the ‘‘new”” tty driver. 
nextkey: data base subroutines. So ay 

nice. renice: ig peat ee 

nice listings of programs. rene ome aie Val) Se 

nice, nohup: run a command at low ariarige 
nice: run low priority process. . . 


e 2 e 2 2 


e e s se 


nice: set program priority. . . . 1... ee ee 
nlist: get entries from mame list. ....... 
nm: print name list. ot ae a 


nohup: run a command at low Sort (sh 
nohup: run command immune to hangups. 
NOM=!0Cal COICO: se ow ae Se A SA ES 
MOUNGACON: “ac 2s Swe ear Se H.R 
notification. ... -— 
notified if mail arrives and he it is efron: a @ 
notify: request immediate notification. .... 
MFO NOUt:. . a. 4e ce bind a. es im Bee es eS 
nroff or troff. ..... ie Yonues Spratt, oe 
nroff output for CRT sreviewing, eth ee 
nroff: text formatting and typesetting. ; 


nroff, troff, tbl and eqn constructs. ...... 
nroff/troff files. ee ee ee ee ee 
null: datasink. ...... 


num: number lines. F 

number: convert Arabic anmiees to Eawiieh: 
number facts. fe thee. tet. oe foe Go 

number generator. 2... 6 6 se ew wa 
MUMDEL NINES: a oh ce el a we es, re 
MUMIDEIS: area a de eS ee Te 
MNuUMmDEers. ANITO,>. =. ee es we we Se 
numerals to English.  . 
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mktemp(3) 
pwd(1) 
tty (1) 
netlogin(1) 
getpw (3) 
nlist (3) 

nm (1) 
symorder (1) 
ttyname(3) 
chfn (1) 
esh(1) 

term (7) 
ncheck (8) 
dumpdir(8) 
ncheck (8) 
eqn(1) 
netcp(1) 
netipr(1) 
net(1) 
netcp(1) 
netlog (1) 
netlogin(1) 
netipr(1) 
netmail (1) 
netq(1) 
netrm (1) 
nettroff(1) 
netmail(1) 
nettroft(1) 
netlog (1) 
netq(1) 
netrm (1) 
newcsh (1) 
creat(2) 
arcv (8) 
newgrp(1) 
fork (2) 
vfork (2v) 
newtty (4) 
esh(1) 
adduser (8) 
newaliases (1) 
newcesh(1) 
newgrp(1) 
sh(1) 
newity (4) 
dbm(3x) 
renice (8) 
verind(1) 
nice (1) 
esh(1) 

nice (2) 
nlist (3) 

nm (1) 
nice (1) 
esh(1) 
setymp (3) 
esh(1) 
mail (4) 
biff(1) 
esh(1) 
soelim (1) 
tbi(1) 
colert(1) 
trofi(1) 
deroff(1) 
checknr(1) 
null (4) 
num (1) 
number (6) 
arithmetic (6) 
rand (3) 
num (1) 
atof (3) 
intro (2) 
number (6) 


Permuted Index 


size: size of an 

lorder: find ordering relation for an 
what: show what versions of 

strings: find the printable strings in a 
od: 


acct: turn accounting on or 
prmail: print out mail in the post 


old: directory of 
newcsh: description of new csh features (over 
login: sign 


nohup: run a command at low priority (sA 
program fle including aliases and paths (csA 
| fopen, freopen, fdopen: 
dup, dup2: duplicate an 

open: 


plot: 

savecore: save a core dump of the 

tgetstr, (goto, {puts: terminal independent 
strcpy, strncpy, strien, index, rindex: string 
} join: relational database 
curses: screen functions with 

stty: set terminal 

lastcomm: show last commands executed in reverse 
lorder: find 

vi: screen 

a.out: assembler and link editor 

ecvt, fevt, gcvt: 

printf, fprintf, sprintf: formatted 

fold: fold long lines for finite width 

colert: filter nroff 

foreach: loop 

newcsh: description of new csh features 
netmail: read mail on a remote machine 
netroff: troff to the phototypesetter 

exec: 

chown: change 

chown, cherp: change 

quot: summarize file system 

stdio: standard buffered input/output 
more, 

tk: 

swapon: specify additional device for 
drum: 

vadvise: give advice to 

vswapon. add a swap device for interleaved 
me: macros for formatting 

pe: 

pxref: 

pxp: 

pmierge: 

DX: 

DIX: 

pi: 


ge(pass: read a 

passwd: change login 

passwd: 

getpwuid, getpwnam, setpwent, endpwent: get 
vipw: edit the 

netlogin: provide login name and 

which: locate a program file including aliases and 
grep, egrep, fgrep: search a file for a 

awk: 


popen, 

delivermail: deliver mail to arbitrary 
mesg: 

ptx: 

limit: alter 

messages. 


object file. 

object library. : 

object modules were used to cansitucl a vale 
object, or other binary, file. 

octal dump. 
od: octal dump. 
GH ‘sas Yb a oe gow oe 
office. ....... 

old: directory of old aiogtanies 
old programs. 
oldcsh). 

CRS Se of eo Soir Brod: Co -en  B, 
onintr: process interrupts in command scripts. 
only). nice, 
only). which: locate a 

open a stream. 

open file descriptor. : 

open for reading or writing. ‘ 
open: open for reading or writing. 
openpl et al.: graphics interface. 
operating system. ‘ be He AEE ee Sa 
operation routines. tgetent, tgetnum. tgetflag, 
operations. strcat, strncat, stremp, strncmp, 
operator. : : 
‘“optumal”’ 
options. 
O6GGt.-. ae ek re 

ordering relation for an object library. 
oriented (visual) display editor based on ex. 
output. 
output conversion. 
outpul conversion. 
output device. 
output for CRT previewing. 
over list of names. 
(over oldcsh). 
over the network. 
over the network. 
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overlay shell with epecihied eonnaad. 
owner and group ofa file. .. 
owner or group. ..... 
ownership. .....6. 
PECKGSG, «ce SS 


page: file perusal filter for crt giewind: 
paginator for the Tektronix 4014. 
paging and swapping. ... 

paging device. ‘ 

paging system. 
paging/ swapping. 
papers. 
Pascal compiler. 
Pascal cross-reference program. 
Pascal execution profiler. 

pascal file merger. 
Pascal interpreter. : . 
Pascal interpreter and executor, ....... 2080-8 
Pascal interpreter code translator. 

passwd: change login password. 

passwd: password file. 
password. 
password. 
password file. 
password file entry. getnwenk. 
password file with vi. 5 4 
password for a remote machine: 
paths (csh only). 
pattern. Es ig eae adc lae <a. , Ye 
pattern sinning and processing language. 
pause: stop until signal. ‘ 
pc: Pascal compiler. ; 

pclose: initiate I/O to/from a spaces. 
people. 
permit or deny messages. .. 
permuted index. 
per-process resource limitations. 
perror, sys_errlist, sys_nerr: system error 
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size (1) 
lorder(1) 
what(1) 
strings (1) 
od(1) 

od(1) 
acct(2) 
prmail(1) 
old{8) 

old (8) 
newcsh(1) 
login (1) 
csh(1) 

nice (1) 
which(1) 
fopen(3S) 
dup(2) 
open(2) 
open(2) 
plot(3x) 
savecore (8) 
termcap(3) 
string (3) 
join(1) 
curses (3) 
stty (1) 
lastcomm (1) 
lorder(1) 
vill) 
a.out(S) 
ecvt(3) 
printf (3S) 
fold (1) 
colert(1) 
esh(1) 
newcsh(1) 
netmail (1) 
nettroff(]) 
esh(1) 
chown (2) 
chown (8) 
quot (8) 
stdio (3S) 
more (1) 

tk (1) 
swapon(8) 
drum (4) 
vadvise (2v) 
vswapon(2v) 
me({7) 
pe(1) 
pxref(1) 
pxp (1) 
pmerge(1) 
px (1) 

pix (1) 

pi(1) 
passwd (1) 
passwd (5) 
getpass (3) 
passwd(1) 
passwd (5) 
getpwent (5) 
vipw (8) 
netlogin(1) 
which(]) 
grep(1) 
awk (1) 
pause (2) 
pe(1) 

popen (3S) 
delivermail (8) 
mesg(1) 
pix (1) 
esh(1) 
perror (3) 


sticky: executable files with 
more, page: file 

Ct: 

pu: 

nettroff: troff to the 

te: 


split: split a file into 
tee: 


bg: 
fish: 
mille: 
boggle: 
worm: 


cifplot: CIF interpreter and 
vtroff: troff to a raster 


lseek, tell: move read/write 


popd: 


ttytype: data base of terminal types by 

prmail: print out mail in the 

analyze: Virtual UNIX 

root. exp, log, log10, 

exp, log, log!0, pow, sart: exponential, logarithm, 


print: 

kill: terminate a process with extreme 
monitor: 

colert: filter nroff output for CRT 
types: 

cat: catenate and 

fortune: 

date: 

cal: 

hashstat: 

netq: 

jobs: 

whoam!: 

pr: 

history: 

banner: 

Ipr, Iprm. Ipaq, 

nm: 

vfontinfo: inspect and 

prmail: 

printenyv: 

man: find manual information by keywords; 


vpac: 
pstat: 

netlog: 

dumpdir: 

diction explain: 
diction,explain: 

file. strings: find the 


banner: print large banner on 
Ip: line 

print: pr to the line 

lpr, lprm, ipq, print: line 
vpac: print raster 

vpr, vprm, vpq, vprint: raster 
conversion. 

nice: set program 

nice, nohup: run a command at low 
renice: alter 

nice: run low 


adduser: 


persistent text. ... ge hae. id 

perusal filter for crt viewing: 
phototypesetter interface. 

phototypesetter interpreter. 
phototypesetter over the network. 
photypesetter simulator. 

pi: Pascal interpreter code translater, 
pieces. 

pipe: create an pierprocess channel 

pipe fitting. 

pix: Pascal aterpRRier and: executor. 

place job in background. 

play ‘‘Go Fish’’. 

play Mille Bournes. 

play the game of boggle. 

Play the growing worm game. 

plot: graphics filters. 

plot: graphics interface. : , 
plot: openpl et al.: graphics niert ace: 
plotter. Dalek a a wk kt OS 

plotter. 

pmerge: pascal file mereer. 

pointer. 

pop shell directory sack 

popd: pop shell directory stack. ate 
popen, pclose: initiate 1/O to/from a nigeess 
port... 

post office. si ; 

postmortem crash analyzer: ; : 
pow, sqrt: exponential, logarithm, newer square 
power, square root. © ee Se. oy 
pr: print file. 

pr to the line printer. 

prejudice. . . 

prepare execution profile: 

previewing. ; 

primitive system daca nes: 

print. 

print a tanidorn: nopeluily inveresting. Adages: 
print and set the date. — 

print calendar. : 

print command hashing Seatistics: 

print contents of network queue. 

print current job list. ; 

print effective current user ‘<, 

print file. : 

print history event list. 

print large banner on printer. 

print: line printer spooler. 

print name list. : 

print out information about | unix ‘fonts. 
print out mail in the post office. 

print out the environment. 

print out the manual. 

print: pr to the line printer. 


print raster printer/ploter accounting iaformalon: 


print systern facts. 

print the last few lines of the network log file. 
print the names of files on a dump tape. 
print wordy sentences: thesaurus for diction. 
print wordy sentences, thesaurus for diction. 
printable strings in a object, or other binary. 
printeny: print out the environment. 

printer. 

printer. 

printer. 

printer spooler. 

printer/ploter ascewuntinn aloniaued. 
printer/plotter spooler. 

printf, fprintf, sprintf: formatted output 
priority. 

priority (sé Bait — P 
priority of running process by changing nice. 
priority process. ’ 

prmail: print out mail in ‘the post ‘office. 
procedure for adding new users. 
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Permuted Index 


sticky (8) 
more(1) 
ct(4) 
pti(l) 
nettroff(1) 
tc(1) 

pi(1) 
split(]) 
pipe (2) 
tee(1) 
pix (1) 
csh(1) 
fish (6) 
mille (6) 
boggle(6) 
worm (6) 
plot(1G) 
plot(5) 
plot(3x) 
cifplot(1) 
viroff(]) 
pmerge(1) 
Iseek (2) 
esh(]) 
esh(1) 
popen (3S) 
ttytype (5) 
prmail (1) 
analyze (8) 
exp(3M) 
exp(3M) 
pr(l) 
print(1) 
kill (1) 
monitor (3) 
colert(]) 
types(5) 
cat(]) 
fortune (6) 
date(1) 
cal(1) 
esh(1) 
netq(1) 
cesh( 1) 
whoami(]) 
pr(1) 
esh(1) 
banner (95) 
lor (1) 

nm (1) 
vfontinfo (1) 
ormail (1) 
printenv (1) 
man(1) 
orint(1) 
vpac(8) 
pstat(8) 
netlog(1) 
dumpdir(8) 
diction!) 
explain (1) 
strings (1) 
printenv (1) 
banner (6) 
Ip(4) 
print(1) 
Ipr(1) 
vpac(S) 
vpr(l) 
printt(3S) 
nice (2) 
nice (1) 
renice (8) 
esh(]) 
prmail(1) 
adduser (8) 
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reboot: UNIX bootstrapping 
nice: run low priority 

stop: halt a job or 

exit: terminate 

fork: spawn new 

kill: send signal to a 

popen, pclose: initiate 1/O to/from a 
wail: await completion of 
renice: alter priority of running 
mit: 

killpg: send signal to a process or a 
selpgerp, geipgerp: set/get 
geipid: get 

viork: spawn new 

oninir: 

killpg: send signal to a 

7 DS: 

times: get 

wait: wait for 

wait3: wait for 

ptrace: 

kill: terminate a 

kill: kill jobs and 

wait: wait for background 

awk: pattern scanning and 
hait: stop the 

m4: macro 

reboot: reboot systern or halt 


monitor: prepare execution 
profil: execution time 

prof: display 

pxp: Pascal execution 

end, etext, edata: last locations in 
finger: user information lookup 
liszt: compile a Franz Lisp 

Ixref: lisp cross reference 

msgs: sysiem messages and junk mail 
mt: magnetic tape manipulating 
pxref: Pascal cross-reference 
units: conversion 

whereis: locate source, binary, and or manual for 
cb: C 

only). which: locate a 

make: maintain 

nice: set 

assert: 

lint: a C 

lex: generator of lexical analysis 
old: directory of old 

struct: structure Fortran 

verind: grind nice listings of 

xstr: extract strings from C 
arithmetic: 

machine. netlogin: 

true, false: 


miail: 


doctor: interact with a 


ungeic: 
pushd: 


puts, fputs: 

putc, putchar, fputc, putw: 
on 8 stream. 

stream. putc, 


putc, putchar, fputc, 


procedures. 
process. 
process. . 
process. .... 
process. 
process. 
process. . 
process. 
process by changing nice. 

process control iniualization. 
process group. 
process group. 
process identification. 
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process in a virtual memory efficient way. 


process interrupts in command scripts. 
process or a process group. 
process Status. 
process times. 
process to terminate. 
process to terminate. 
process trace. : 
process with extreme prejudice. ... 
processes. 
processes (o complete. ; 
processing language. 
processor. 
processor. 
processor. 
prof: display profile data. ...... 
profil: execution time profile. .... 
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BFONIG, --6. wc: oe cee ee Ss Sw 
profile. ...... Sn! vee ceed ; 
DROUIE Gaia, .4.0s whe Bye heck sah Sach ae 
POONER. se oer a ars pose 
program. ..... eae te ea es 
progtam:... shed ¥. oe aoe : 
program. ..... He Oh ae ee Sok, | 
program. ... 2.0.6. ; ; 
OFOgtam.. 44, 2. 6 A Se ee ee 
Broulam., «4 a - 84 ale % Pa 
BrOGTaiN.. & aoa ee « Sore AS ae 
DfOgtam: “e628. eae ws Sh ee 
BOCA. ephedra BS Soe Ss 
program beautifier. ........2. 


program file including aliases and paths (csé 


program groups. ...... 


PrOgfaim PTiOTUy.. soa ecw Se es eS WE 
program verification. . . 2.1... 5 6 6 « 


program verifier. 
programs. 
programs. 
programs. 
programs. 
programs to implement shared strings. 
provide drill in number facts. | 
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provide login name and password for a remote 


provide truth values. 


pS: process status. ges ae He canoes 24 
pseudo-device for mail notification. : 
pstat: print system facts. ena a> tat Be 
psychoanglySt. 6 «© 66 e:% 0 6 % 


pul: phototypesetter interpreter. 1 
ptrace: process trace. 
pix: permuted index. 
push character back into input stream. 
push shell directory stack. 


pushd: push shell directory stack. ee 


pul a String on a stream. 
pul character or word on a stream. 


@ e 
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putc, putchar, fputc, putw: put character or word wick % 
putchar, fputc, putw: put character or wordona .... 


puts, fputs: put a string on a stream, . 
putw: put character or word on a stream. 
pwd: working directory name. 
px: Pascal interpreter. 
pxp: Pascal execution profiler. 
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renice (8) 
init (8) 
killpg (2)) 
setpgrp(2j) 
getpid(2) 
vfork (2v) 
esh(1) 
killpg (2j) 
ps(1) 
tumes (2) 
wait(2) 
wait3 (2}) 
ptrace (2) 
kill (i) 
esh(1) 
esh(1) 

awk (1) 
hait (8) 
m4(1) 
reboot (2v) 
prof(]) 
profil(2) 
monitor (3) 
profil(2) 
prof(1) 
pxp(]) 
end(3) 
finger (1) 
liszt (1) 
ixref(1) 
msgs (1) 
mt()) 
pxref(1) 
units (]) 
whereis(1) 
cb (i) 
which(1) 
make(1) 
nice (2) 
assert (3x) 
lint (1) 

lex (1) 

oid (8) 
struct (1) 
vgrind(1) 
xsir(]) 
arithmetic (6) 
netlogin (1) 
true(1) 
ps(1) 

mail (4) 
psiat (8) 
doctor (6) 
pti(]) 
ptrace (2) 
ptx (]) 
ungetc(35) 
esh(]) 
esh(1) 
puts(3S) 
putc (3S) 
putc(3S) 
putc(3S) 
puts(3S) 
puic(3S) 
pwd (1) 
px(i) 
pxp(1) 


netq: print contents of network 
netrm: remove a command from the network 


qsort: 


rv: 
rain: animated 


fortune: print a 
ranlib: convert archives to 
rand, srand: 


viroff: troff to a 
vpac: print 
vpr, vprm, vpq, vprint: 


ratfor: 


getpass: 
source: 
read: 
netmail: 


wait:/ /cd, eval, exec, exit, export, login, newegrp, 
vread: 

open: open for 

/ed, eval, exec, exit, export, login, newegrp, read, 
bad 144: 

lseek, tell: move 

malloc, free, 

symorder: 


reboot: 


newaliases: 
mail: send and 
mail: send or 


rehash: 

utmp, wimp: login 

eyacc: modified yacc allowing much improved error 
eval: 

re_comp, 

references in documents. 

Ixref: lisp cross 

refer, lookbib: find and insert literature 

re_comp, re_exec: 


comm: select or 

lorder: find ordering 

join: 

strip: remove symbols and 
leave: 

calendar: 

netcp: 

uusend: send a file to a 
netipr: use a 

net: execute a command ona 
netlogin: provide login name and password for a 
netmail: read mail ona 
netrm: 

unalias: 

colrm: 

unlink: 

unsetenv: 

mount, umount: mount or 
deroff: 

unlimit: 

Strip: 

rm, rmdir: 

mv: move or 

changing nice. 

fsck: file system consistency check and interactive 


pxref: Pascal cross-reference program. 
qsort: quicker sort. ..... 
queue. is ca ae Got es Bt as Se ee 
queue. ws he “ae (62 ee cae a 
Quicker sort. .... be oke Ga 
quiz: test your knowledge. a, 
quot: summarize file system ownership. 
Racal/Vadic ACU interface. . 
rain: animated raindrops display. .. . 
raindrops display. fe OS. tae tare ; 
rand, srand: random number generator. 
random, hopefully interesting, adage. 
random libraries. .....2... 
random number generator. ... 
ranlib: convert archives to random \ibcarie’. 
raster plotter. eM ee oe ote 

raster printer/ploter accounting information. 
raster printer/plotter spooler. : 
ratfor: rational Fortran dialect. a3 
rational Fortran dialect. 

rc: command script for auto- ebook and: daemons. 
read a password. .... 
read commands from Mle. 
read from file. ..... So 6h gus 
read mail on a remote machine over the aniwork: 
read: read from file. S. Sr Ae ck Seek 

read, readonly, set, shift, times, trap, araaek: 
read virtually. . ..... 

reading or writing. 

readonly, set, shift, times, as. nei isk war 


~, 


read/write dec standard 144 bad sector information. 


read/write pointer. ..... 

realloc, calloc: main memory allocator. 
rearrange name list. oe . 
reboot: reboot system or halt nrosessor: 
reboot system or halt processor. .... 
reboot: UNIX bootstrapping procedures. 
rebuild the data base for the mail aliases file. 


receive mail. a! ae Sar ta ee? Ss, Se el me BE 
receive mail among users. 5p as The ass 
re_comp, re_exec: regular axoression handler. 
recompute command hash table. ...... 
FECOCES. 4 ka a Be we ete a 
FOCOVER)... “a. ee. wt ae hw Seo 3 ‘ 


re-evaluate shell data. Boa : 
re_exec: regular expression Handler. 
refer, lookbib: find and insert literature 
reference program. ........ 
references in documents. 

regular expression handler. ; 
rehash: recompute command hash table, 
reject lines common to two sorted files. 
relation for an object library. 

relational database operator. 


relocation bits. ..... : 3 

remind you when you have t to leave: : 
reminder service. nwa ; i Sh GBs 
remote copy of files through: the a) 
remote host. ds ly ; bo OS. ae a OR 
remote lineprinter through the net. Se eh at? a Me 


FEMMOte Machines «2 6 4k we ee we 
fEPNOLE HACKING. «4 4A: & @ 4S aw Se eo 
remote machine over the network. .. ee 
remove a command from the network queue. 


remove aliases. i J wea dhe A Sas 
remove columns from a file. Bact, tah ieee as: 
remove directory entry. .. . .. 2. «wae 
remove environment variables. 

remove file system. go ee eB Bee 
remove nroff, troff, tbl and eqn constructs. 
remove resource limitiations. a ee ee 
remove symbols and relocation bits. . 
remove (unlink) files. Botan tes Gace at beet 
rename files. eae Se 
renice: alter priority of sGaning ree by 
repair. Go eat Ce Se 
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oxref(]) 
qsort(3) 
netq(1) 
netrm (1) 
qsort(3) 
quiz(6) 
quot(8) 
rv(4) 
rain(6) 
rain(6) 
rand(3) 
fortune (6) 
ranlib(1) 
rand (3) 
ranlib(1) 
vtroff (1) 
vpac(8) 
vpr(1) 
ratfor(1) 
ratfor(1) 
re(8) 
getpass(3) 
esh(1) 
read(2) 
netmail (1) 
read (2) 
sh(1) 
vread(2v) 
open(2) 
sh(1) 
had144(8) 
Iseek (2) 
malloc(3) 
symorder(j) 
reboot(2v) 
reboot(2v) 
reboot(8) 
newaliases(]) 
mail (1) 
binmail (1) 
regex (3) 
esh(1) 
utmp(5) 
eyacc(1) 
esh(]) 
regex (3) 
refer(1) 
Ixref(1) 
refer(1) 
regex (3) 
esh(1) 
comm (1) 
lorder (1) 
join(1) 
strip(1) 
leave (1) 
calendar (1) 
netcp(]) 
uusend(!C) 
netlpr(1) 
net(]) 
netlogin (1) 
netmail(1) 
netrm(]) 
esh(1) 
colrm(1) 
unlink (2) 
csh(1) 
mount(2) 
deroff(1) 
esh(1) 
strip( |) 
rm (1) 
mv(1) 
renice (8) 
fsck (8) 


Permuted Index 


while: 


unig: report 

repeat: execute command 
yes: be 

iostat: 

uniq: 

vmstat: 

fseek, ftell, rewind: 
notify: 

lock: 


reset: 

vlimit: control maximum system 
limit: alter per-process 

unlimit: remove 

vuimes: get information about 


restor: incrementai file system 
suspend: suspend a shell, 


col: filter 

rev: 

lastcomm: snow last commands executed in 
to fseek, fteil, 


rewind: 

strcmp, strncmp, sircpy, strncpy, strien, index, 
call: 

hk: RK6-11/RK06 and 

hk: 


hp: RPQ6, 

hp: RP06. RMO3, 

hp: RPO6, RMO3, RMOS5, 
rm, 

chase: Try to escape to killer 


pow, sqrt: exponential, logarithm, power, square 
. (goto, (puts: terminal independent operation 

, disk. hop: 

hp: RP06, RM03, RMO5, RM80, 

nice, nohup: 

nohup: 

nice: 

renice: alter priority of 


savecore: 
brk, 


awk: pattern 

alarm: 

clear: clear terminal 
curses: 

ex. Viz 

rc: command 


onintr: process interrupts in command 


grep, egrep, fgrep: 

xsend, xget, enroll: 

bad144: read/write dec standard 144 bad 
~ padsect: create files to contain bad 


see: 
comm: 
case: 
uusend: 
mail: 
mail: 
kill: 


killpg: 


reset: reset the teletype bits to a 


repeat commands conditionally, ......2...4.., esh(1) 
repeat: execute command repeatedly. .......4.. csh(1) 
repeated linesina file. ............... uniq(1) 
FOQCAIEGIV. gk ope ed, So eK Ee eS Sw csh(1) 
repetitively affirmative. . ............4. yes(1) 
report I/O Stauistics.. ga beds ww eee Se as wed iostat(1) 
report repeated linesina file. .........24202. umiq(1) 
report virtual memory statistics. ......2..204.28. vmstat(]) 
FENOSILIGH aSITRAM.. cs 4 i RS Aw ae ce eels & fseex (3S) 
request immediate notification. ........... esh(1) 
fOSELVE a terminal, se 8) be 6 SRS a ee ee wn lock (1) 
reset: reset the teletype bits to a sensible state. reset(1) 
reset the teletype bits to a sensible state. . ....4.. reset(|) 
FESOUrCe CONSHUMDNON, <. 24% 265% bE eS Ss vlimit (2v) 
FESOUICEHIMUANIONS: . <5 2c 26 ss GS Re Boe eee esh(1) 
resource limitiations. .... 0.0.0... 0.28688 ee csh(1) 
resource utilization. . ......2...68884888 vtimes(2v) 
restor: incremental file system restore. .....2.2.2. restor(8) 
TOSIOTE. 6 cds Wik rs OO RO Oe OO eS MS Ee restor (8) 
resuming itS superior, .......2.2... e884 esh(1) 
rev: reverse lines of a file. 2. .......2..886-.4 rev(1) 
reverse line feeds. ......2...0.2.0808+4 e008. col(1) 
reverse lines ofafile. ...........2e24088-4 rev(1) 
FEVGTSO OFGEE! ou. a Fo GS Oo HES BES MSS lastcomm (1) 
rewind: reposition a stream. .........68888 fseek (3S) 
rewind: rewind tape drive. ........6:e808e-8 rewind (1) 
rewind tape drive. ........0 50 ce ee een rewind (1) 
rindex: string operations. strcat, strmcal, ....... string (3) 
Fife a: (GClSDNGHE: - eo. e025 ee BS Re wt ota isk call (iC) 
RKO7 moving head disk. ........0. 20202066 hk (4) 
RK6-11/RK06 and RKO7 moving head disk. ..... hk (4) 

rm, rmdir: remove (unlink) files. .......2.2.., rm (i) 
RM03, RMO5, RM80, RPO7 MASSBUS moving-head disk. hp(4) 
RM05, RM80, RPO7 MASSBUS moving-head disk. hp(4) 
RM80, RPO7 MASSBUS moving-head disk. ..... hp(4) 
rmdir: remove (unlink) files. .....2.2.2.2.2.2.4.2.. rm(1) 
FOOOUS. ° os eee can re Se Sn a A. ee cee ee ee chase (6) 
rogue: Exploring The Dungeons of Doom. ...... rogue (5) 
root. “exp; log, J0g10, kn ee ec we we eee ES exp(3M) 
routines. tgetent, tgetnum, tgetflag, tgetstr, ..... iermcap(3) 
RP06, RM03, RMO5, RM80, RPO? MASSBUS moving-head hp(4) 
RPO? MASSBUS moving-head disk. . ......4. hp(4) 

run a command at low priority (seonly). ....... nice (1) 
run command immune.to hangups. ....... esh(1) 
run low priority process. ......4.2.. esh(1) 
running process by changing nice. ......4.2.2.. renice (8) 
rv: Racal/Vadic ACU interface. ........2048. rv(4) 

sa, accton: system accounting. ......... 6... sa(&) 

save a core dump of the operating system. ...... savecore(8) 
savecore: save a core dump of the operating system. savecore (8) 
sbrk, break: change core allocation. ......0.648-. brk (2) 
scanf, fscanf, sscanf: formatted input conversion. scanf (3S) 
scanning and processing language. ........e-. awk (1) 
schedule signal after specified time. ......... alarm (2) 
SCREEN: Glas iae ce Meche a Se a OA AMO ees GS es clear(1) 
screen functions with “‘optimal’’ cursor motion. curses (3) 
screen oriented (visual) display editor based on vill) 
script for auto-reboot and daemons. ........-. ro(8) 
script: make typescript of terminal session. ...... script(1) 
SCTIOUSS. 1d. ows ec at ed nee Me 8, SN eee, et esh(1) 
sdb: symbolic debugger. .......6 2008888 sdb(1) 
search a file for a pattern. .... 2... ee ee eee grep(1) 
SOCTOUTHail> me ES ee, Bs Ste ed A a utes So xsend(}) 
sector information. . . . 2.06. 2 6 ee ee ee bad144(8) 
SEEIOES:. <n deh. & commu: Oa Sa a ee eS badsect (8) 
sed: stream editor, .. . 2... ee we ee ee wes sed (1) 
see: see whata file hasinit. ...........4.. see (1) 

see what a file Nas iat... 6 ew. hw we ae Sow wp ee see (1) 
select or reject lines common to two sorted Ales. comm(]) 
SCIECIOPAGSWUCHS. dacs SS: wd eee BOA BY we BG A esh(1) 
send a file to aremote host. .........0246e08-8 uusend{1C) 
send and receive mail. ........2...8080808-.8 mail (1) 
send or receive mail among users. .......2.4.. binmail (1) 
send signal t0 a process. 5 ww ww ew ew ee te kill(2) 
send signal to a process or a process group. ...... killpg (2j) 
SENSIDIE Sigi@,. jaws a A ae we Se Ae we ee eS reset(1) 
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diction,explain: print wordy 
diction,explain: print wordy 
calendar: rerninder 

logout: end 

script: make typescript of terminal 
ascii: map of ASCII] character 


umask: 

uuime: 

nice: 

/exec, exit, export, login, newgrp, read, readonly, 
getty: 

tset: 

stty: 

tabs: 

date: print and 
stime: 

setuid, setgid: 
setenv: 


entry. getfsent, getfsspec, getfsfile, 
Setpgrp, getpgrp: 

setuid, 

getgrent, get#rgid, getgrnam, 


crypt, 
getpwent, getpwuid, getpwnam, 


continue, cd, eval, exec, exit, export, login,/ 
xstr: extract strings from C programs to implement 
chsh: change default login 

exit: leave 

system: issue a 

esh: a 

eval: re-evaluate 

popd: pop 

pushd: push 

alias: 

suspend: suspend a 

set: change value of 

@: arithmetic on 

unset: discard 

exec: overlay 


/exit, export, login, newerp, read, readonly, set, 
upume: 

lastcomm: 

construct a file. what: 


signals. sigset, signal, 
sigset, signal, sighold, 
login: 

pause: stop until 
alarm: schedule 


manage signals. sigset, 

kill: send 

killpg: send 

signal: catch or ignore 

sighold, sigignore, sigrelse, sigpause: manage 
sigsyS: catch or ignore 

sigset, signal, sighold, sigignore, sigrelse, 
sigset, signal, sighold, sigignore, 

sigpause: manage signals. 


tc: photypesetter 
trigonometric functions. 


null: data 
size: 


spline: interoolate 


sentences, thesaurus for diction. 
sentences; thesaurus for diction. 
service. 
session. 
session. 
SEQ: le ae A 2 
set: change value of shell! variable. 
set file creation mode mask. 
set file times. a oe 
set program priority. ; 
set, shift, times, trap, umask, wait: command! 
set terminal mode. 
set terminal modes. 
set terminal options. 
set terminal tabs. 
set the date. 
set time. ; 
set user and group ID. 
set variable in environment. 
setbuf: assign buffering to a stream. 
setenv: set variable in environment. 
setfsent, endfsent: get file system descriptor file. 
set/get process group. : 
setgid: set user and group ID. oe 
setgrent, endgrent: get group file entry. 
seyump, longjymp: non-local goto. 
setkey, encrypt: DES encryption. 
setperp, getpgrp: set/get process group. 
setpwent, endpwent: get password file entry. 
setuid, setgid: set user and group ID. 
sh, for, case, if, while, :, ., break, 
shared strings. 
shell. 
Shells <2 
Shell command. : 
shell (command saletoreien). we C. like evatae 
shell data. 
shell directory stack. 
shell directory stack. 
shell macros. ; 
shell, resuming its superior. 
shell variable. : 
shell variables. 
shell variables. be te 
shell with specified coriiniand 
shift: manipulate argument list. 
shift, times, trap, umask, wait: command ngdage: 
show how long system has been up. F ; 
show last commands executed in reverse eden 
show what versions of object modules were used to 
shutdown: close down the system ata given ume. 
sighold, sigignore, sigrelse, sigpause: manage 
sigignore, sigrelse, sigpause: manage signals. 
sign on. 
signal. ; 
signal after gadcined tae 
signal: catch or ignore signals. . P 
signal, sighold, sigignore, sigrelse, sigpause: 
signal to a process. 
Signal to a process or a process soup. 
signals. fnlece We Gas al AAT at Rt a, a KE Has 
signals. sigset, Signal, Ope ae a ae oe ee ee a 
signals. : : 
Sigpause: manage senile: ‘ 
sigrelse, sigpause: manage signals. 
sigset, signal, sighold, sigignore, sigrelse, 
sigsys: catch or ia ee 
simulator. 
Sin, COS, tan, asin, acos, alan, aia 
sinh, cosh, tanh: hyperbolic functions. 
StiK ss. “eho dae. 4 
size of an object file. 
size: size of an object file. 
sleep: suspend execution for an Aiea. 
sleep: suspend execution for interval. 
smooth curve. 
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Permuted Index 


diction(1) 
explain(1) 
calendar (1) 
esh(1) 
script (1) 
ascii (7) 
esh(1) 
umask (2) 
utime (2) 
nice (2) 
sh(1) 
getty (8) 
tset(1) 
stty (1) 
tabs (1) 
date(1!) 
stime (2) 
setuid (2) 
esh(1) 
setbuf (3S) 
csh(1) 
getfsent(3) 
setperp(2)) 
setuid (2) 
getgrent(3) 
setymp(3) 
crypt(3) 
setperp(2)) 
getpwent(3) 
setuid (2) 
sh(i) 
xstr(1) 
chsh(1) 
esh(1) 
system (3) 
csh(1) 
esh(1) 
esh(1) 
esh(1) 
esh(1) 
csh(1) 
esh(1) 
esh(1) 
csh(t) 
esh(1) 
csh(1) 
sh(1) 
uptime (1) 
lastcomm (1) 
what (1) 
shutdown (8) 
sigset(3) 
sigset (3) 
login (1) 
pause (2) 
alarm (2) 
signal (2) 
sigset (3) 
kill (2) 
killpg (2)) 
signal (2) 
sigset(3) 
sigsys (2j) 
sigset (3) 
sigset(3) 
sigset(3) 
sigsys(2j) 
tc(1) 
sin(3M) 
sinh (3M) 
null (4) 
size(1) 
size (1) 
sleep/1) 
sleep (3) 
spline (1G) 


Permuted / ndex 


snake, 


qsort: quicker 
tsort: topological 
sort: 


comm: select or reject lines common to two 

look: find lines in a 

soelim: eliminate 

mkstr: create an error message file by massaging C 
wheres: locate 


expand, unexpand: expand tabs to 
fork: 

way. viork: 

exec: overlay shell with 

alarm: schedule signal after 
swapon: 


spell, 
spell, spellin, spellout: find 
spell, spellin, 


split: 
frexp, ldexp, modf: 


uuclean: uucp 

ipr, Iprm, Ipq, print: line printer 

vpr, vprm, vpq, vprint: raster printer/plotter 
printf, fprintf, 

exp, log, log10, pow, 

logl0, pow, sqrt: exponential, logarithm, power, 
rand, 

scan{, Iscantf, 

popd: pop shell directory 
pushd: push shell directory 
bad 144: read/write dec 

; stdio: 

gets: get a string from 


reset: reset the teletype bits to a sensible 
if: conditional 

fstab: 

hashstat: print command hashing 

iostat: report 1/O 

vmstat: report virtual memory 

ps: process 

S$: system/ process 

stat, fstat: get file 

feof, ferror, clearerr, filleno: stream 


halt: 

pause: 

icheck: file system 

up: unibus 

subroutines. dbminit, fetch, 

strlen, index, rindex: string Operations. 

rindex: string operations. strcat, sirncat, 
operations. strcat, strncat, sircmp, strncmp, 
fclose, fflush: close or flush a 

fopen, freopen, fdopen: open a 

fseek, ftell, rewind: reposition a 

getchar, fgetc, getw: get characier or word from 
gets, fgets: get a string from a 

putchar, fputc, putw: put character or word on a 
puts, fputs: pul a string on a 

setbuf: assign buffering to a 

ungetc: push character back into input 

sed: 

feof, ferror, clearerr, fileno: 


snake, snscore: display chase game. snake (6) 
snscore: display chase game. ek ed Be 2 snake (6) 
soelim: eliminate .so’s from nroff input. soelim(1) 
SOEs, . ki cigs 6s and oh we SE ae BE AE Bl, Sree GES qsori(3) 
SOtts. 6 hCe ee Se aS a oe ee eee eS tsort(]) 
sort or merge files. ..... sort(]) 
sort: sort or merge files. sort(]) 
sorted files. comm (1) 
sorted | ist. look (1) 
.so's from nro inpul: ee ee ee ee soelim (1) 
SOURCE. ok Nk a ee S&S Se ae a ag ee mkstr(1) 
source, binary, and or manual for program. whereis(1) 
source: read commands from file. .......06. esh(1) 
spaces, and vice versa. . . . 2. 6 sew eee ew oe expand (1) 
spawn new process. .... 6... : fork (2) 
spawn new process in a virtual memory ‘effident vfork (2v) 
specified command. ....... ety db ot a Bi ao esh(1) 
specified time. .........6. alarm (2) 
specify additional device for paging and swapping. swapon (8) 
spell, spellin, spellout: find spelling errors. we we ee) Spe!) 
spellin, spellout: find ae errors. 18 spell(1) 
spelling errors. falas oe fe ae ek ce Ae . spell()) 
spellout: find spelling « CPOs, ads. oe Bek. Secs . . . spell(]) 
spline: interpolate smooth curve. .......6-. spline (1G) 
split a file into pieces. 2... 1. 2 0 ew ee ee ew ew splic(1) 
split into mantissa and exponent. ck &. autcea es, >... exe) 
split: split a file into pieces. 2. 1. 6 2 we we we split(]) 
spool directory clean-up. .......2.. uuciean (iC) 
spooler. ......06.. gees Se os. a Te lpr (1) 
BOOOIET:, “veven Sh Goh e- e e, SE e  ate ae we eee) 6p) 
sprintf: formatted output conversion. ........ . primtf(3S) 
sqrt: exponential, logarithm, power, square root. exp(3M) 
square root. exp, log, i tec eee oe exp(3M) 
srand: random number generator. rand (3) 
sscanf: formatted input conversion. tee ee ee) Seanf(3S) 
stab: symbol table types. bat Ht Se ia S seed ce we. SIBDLS? 
SACKS 68 aes ae eh ct see Say Se BP ote esh(l) 
StaGk a: Ny. oe: ie Sol Bete 2 a oe ied: ee SHU 
standard 144 bad ‘sector information. wee ew ew ew ww es HAG14-4(8) 
standard buffered input/output package. ...... stdio (3S) 
Standard input. ...... pesien Gu lite Ot sat gets(1) 
stat, fstat: get file status. ...... stat(2) 
State. oe ek is Bee. : a reset(1) 
Statement. Stee hak, Ae as “eye a. Uy ee a Ne Seva ; esh(1) 
static information about the filesystems. Wy ela Gk fstab (S) 
StauisticS.. gs ai. a ‘ ; esh(]) 
StAUSUCS, A ee OK a : jostat{]) 
stausucs. 1... 2.2668. vrnstat(]) 
SUMS. asd, a Gnd ae eee eee: SR ee SE BS ps(1) 
SIQUS seo Ss Sa ee ee ee Re a OR AOS ss (1) 
RUQtS = a. sac wee See Se: HB Re ay fo cah wey dn Nie Ue Ss ee SS stat (2) 
status inquiries. ba Ae et Se eee oe oe ae a ee ee ferror (3S) 
stdio: standard buffered input/output. package. stdio (3S) 
sticky: executable files with persistent text. sticky (8) 
Slime: set time. ...... eee ete Bk Bd we ee SEMA) 
stop: halt a job or process. BF Se tan Be 8b Bee we a OS 
stop the processor. ..... ee a er halt (8) 
stop unul signal. ...... pause (2) 
storage consistency check. ....4.. icheck (8) 
storage module controller/drives. ......068. up(4) 
store, delete, firstkey, nextkey: data base dbm (3x) 
Strcat, strncat, strcmp, strncmp, sircpy, strncpy, string (3) 
strcmp, strncmp, sircpy, strncpy, strien, index, string (3) 
strepy, strncpy, strlen, index, rindex: string ...... string (3) 
Steam. a So atud.2 6 6 ee hk fclose (3S) 
Siream. ..... rads Sen Slo day as teas Ae ae Betts ye Ree fopen (38) 
SEAN coke at ol ae Gente Goa fseek (3S) 
stream. gelc, a ee ee ee ee ee getc(3S) 
SPE AM Yo e oe Ss e) S: eo =e ee % a teas: Te eso, Ge. ‘ gets(3$) 
Stream. DUC. tee. & ah ad Bo Al - we eee Ae putc(3S) 
Stra. 2. sae YS Sn eK ‘ ; puts(3$) 
SEROARNS: | 45 Uk. Sie, St Se te aie eS a setbuf (3S) 
siream. ..... ra de Sorts: Sh Abner ate eS ungetc (3S) 
Stream editor, . . 2... 2 ee eee gS Soy der <2 ie ae se sed(1) 
stream status inquiries. . . 2.0... . 566. «2 « « © ferror(3S) 
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gets, fgets: get a 

gets: get a 

puts, fputs: put a 

strncmp, sircpy, strncpy, strlen, index, rindex: 
extract strings from C programs to implement shared 
other binary, file. 

SUINgS. XStr: extract 

strings: find the printable 

basename: 


sircat, strncat, strcmp, strncmp, sircpy, strncpy, 
index, rindex: string operations. strcat, 

string Operations. strcat, strncat, strcmp, 
Sircal, strncat, strcmp, strncmp, strcpy, 


struct: 
oct, 


document. 


fetch, store, delete, firstkey, nextkey: data base 
SU: 
sum: 


du: 

quot: 

jobs: 

newtty: 

sync: update the 

update: periodically update the 
sync: update 

suspend: suspend a shell, resurning its 
style: analyze 

suspend: 

sleep: 

sleep: 


swab: 

vswapon: add a 

swapping. 

swapon: specify additional device for paging and 
breaksw: exit from 

case: selector in 

default: catchall clause in 

endsw: terminate 


stab: 
sdb: 
strip: remove 


esh: a shell (command interpreter) with C-like 


perror, 
perror, sys_errlist, 

mkfs: construct a file 

mount, umount: mount or remove file 
mount, umount: mount and dismount file 
savecore: save a core dump of the operating 
users: compact list of users who are on the 
vadvise: give advice to paging 

who: who is on the 

rehash: recompute command hash 

unhash: discard command hash 

miab: mounted file system 

stab: symbol 

tbl: format 

tabs: set termina! 


expand, unexpand: expand 
clags: create a 


functions. sin, cos, 


string from astream. ...... 
string from standard inpul. 

string on a stream. . : : 
string operations. strcat, strncat, Sain: 

strings. XStr: - : : 
strings: find the ofintable sities ina ehieck. or 
strings from C programs to implernent shared 
strings in a object, or other binary, file. 

strip filename affixes. . 

strip: remove symbols and relocation bits, 

strlen, index, rindex: string operations. ; 
strncat, strcmp, strncmp, strcpy, strncpy, strien, 
strnemp, strcpy, sirncpy, strlen, index. rindex: 
strncpy, strlen, index, rindex: string operations. 
struct: structure Fortran programs. 

structure Fortran programs. 

sity, gity: control device. 

stty: set terminal options. , 

style: analyze surface characteristics ofa a 

su: substitute user id temporarily. 
subroutines. dbmunit, 

substitute user id temporarily. 

sum and count blocks in a Alle. 
sum: sum and count blocks in a file. 
summarize disk usage. ‘ ‘ 
summarize file system ownership. ? 
summary of job control facilities. 
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summary of the ‘‘new’’ tty driver. . 2... 
super block. . 

super block. pct 

Super-block. ..... 

superior. — , 


surface Haraciecistics ‘of a -Jecumenk: 

suspend a shell, resuming its superior. 

suspend execution for an interval. 

suspend execution for interval. _— ; 
suspend: suspend a shell, resuming 1s leer ar 
swab: swap bytes. oe 

swap bytes. ; 

swap device for aietieaved saaiag/swacoiie: 
swapon: specify additional device for paging and 
SWADDINIE. <a-° sac Nae a! Se ear ee cag 
switch. acer es ae 

switch. a ee 

switch. fa of ods Bs Gr 

switch. Wee ee 

switch: multi-way command branch: 

symbol table types. pe Ts 

symbolic debugger. ......... 
symbols and relocation bis. .... . 
symorder: rearrange name list. : 
sync: update super-block. ... 
sync: update the super block. : 
syntax. .. a dy eM 

syscall: adirect system call. : 
SyS_errlist, syS_nerr: sysiem error messages. 
SyS_nerr: system error messages. 


sysiem. ...... . 

sysiem. . ... 2.6. 

sysiem. ... 2.6; 

SYSIOT <4. are: SA . 
system. . . 2. 2 2 

SYSIGM. uk at A ee Soa eS 

SVStGTiG: Yew aa el bet eS A eS : 


AOI” 3. owe ‘a A ak Ses ee 
TADIES x hn ee Ao &, Ble Bea 


tables 4h. ele Ase Se Btw ee 

table types. a: cde ok ar 

tables for nroff or troff. nie Le : 
tads. Pe ee. GE se, ee ae ee ee Ss 


tabs: set terminal tabs. 
tabs to spaces, and vice versa. 


tags file. ee ease a ate oe oe Ee 
tail: deliver the last part Ore ‘file. se, ‘sat Uae Rec eae 
tan, asin, acos, alan, alan2: trigonometric ..... 
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Permuted Index 


geis(3S) 
gets(1) 
puts (3S) 
string (3) 
xstr(1) 
strings (1) 
xstr(1) 
strings(1) 
basename (1) 
strip(1) 
string (3) 
string (3) 
string (3) 
string (3) 
struct(]) 
struct (1) 
ioctl (2) 
sity (1) 
style (1). 
su(1) 

dbm (3x) 
su(]) 

sum (1) 
sur (1) 
du(1) 
quot (8) 
jobs (3)) 
newtty (4) 
sync (8) 
update (3) 
sync (2) 
esh(1) 
style (1) 
esh(]) 
sleep (1) 
sleep (3) 
esh(1) 
swab(3) 
swab(3) 
vswapon(2v) 
swapon (8) 
swapon(&) 
esh(1) 
esh(1) 
csh()) 
esh(]) 
esh(]) 
stab(S) 
sdb(1) 
strip (1) 
symorder (1) 
sync(2) 
sync(8) 
esh(1) 
syscall (2) 
perror(3) 
perror(3) 
mkfs(8) 
mount(2) 
mount(8) 
savecore (8) 
users(1]) 
vadvise(2y) 
who(]) 


esh(1) 
csh(1) 
mtab«5) 
stab (5) 
(bid) 
tabs(1) 
tabs(}) 
expand (1) 
ctags(1) 
tail(1) 
sin(3M) 


Permuted Index 


sinh, cosh, 

dumpdir: print the names of files on a dump 
tp: manipulate 

tar: 

rewind: rewind 

tp: DEC/mag 

mt: magnetic 


deroff: remove nroff, troff, 


tk: paginator for the 

call: ring a 

reset: reset the 

last: indicate last logins of users and 
lseek, 

su: substitute user id 


lock: reserve a 

ttyname, isatty, ttyslot: find name of a 
vhangup: virtually ““hangup"’ the current control 
worms: animate worms on a display 

termcap: 

tgetent, tgetnum, tgetflag, tgetstr, tgolo, tputs: 
ttys: 

tty: general 

getty: set 

iset: set 

tty: get 

stty: set 

clear: clear 

script: make typescript of 

tabs: set 

itytype: data base of 


wait: wait for process to 
wait3: wait for process to 
kill: 

endif: 

end: 

exit: 

endsw: 


quiz: 

sticky: executable files with persistent 

ed: 

ex, edit: 

fmt: simple 

troff, nroff: 

terminal independent operation routines. 
independent operation routines. tgetent, tgetnum, 
independent operation routines. tgetent, 
operation routines. tgetent, tgetnum, tgetilag, 
routines. tgetent, tgetnum, tgetflag, tgetstr, 
ccat: compress and uncompress files, and cat 
diction.expiain: print wordy sentences, 
diction,explain: print wordy sentences: 

w: who is on and what 

netcp: remote copy of files 

netipr: use a remote lineprinter 

alarm: schedule signal after specified 

at: execute commands at a later 

shutdown: close down the system at a given 
stimeé: set 

time, ftime: get date and 

lume: 

time: 


profil: execution 
gmtime, asctime, timezone: convert date and 


umes: get process 
utime: set file 


tanh: hyperbolic functions. , 
tape. i Sarde ke 
tape aecnive: 

tape archiver. ; 

tape drive. on ae 

tape formats. . 

tape manipulating program. 

tar: lape archiver. tees I, woe, de 

tbl and eqn constructs. .. i acc ee 3 
tbl: format tables for nroff or troff. as Ta sete 
tc: photypesetter simulator. .... . 

OE IPE IUNE: gd. ron ae Bee we 
Tektronix 4014. 3: ...0.....24.. 
telephone. .... a Genee te Carne 
teletype bits to a sensible state. SB. te a ace 
CGIEIY DESo- © aire des er Sete: el Se Se. Re Se Ue 
tell: move read/write pointer, ...... 
temporarily. .. , Set hay 2 
termcap: terminal capability data base. 
terminal. 6 nak Be MRL wes Sh 
terminal. Se Hb ta Ces ek the He oO 


terminal. e ® e e e e@ ° e e e ® e e e e e % 


terminal. ees 3, Teh ae tes Ss 
terminai capability data base. ; 

terminal independent operation routines. 
terminal initialization data. Rie emia ae a es 8 
terminal interface. ......2.2..e86. 
terminal mode. Ae ie eka eS Oe i go 
terminal modes. ........ 

terminal name. a ee ee ee a a ae 
terminal options. ...... 2.65.0 .8 
terminal screen. . . .. 2. 2 6 

terminal session. ....... 

terminal tabs. iat’ tee WSs ode Seek “Se ers 
terminal types by port. ......2... 
terminals: conventional names. Be ida ee a aed 
TOEMTINGIES.. oS ios ee Oe Ge SS 
terminate. .... go ee thes can ee oR ates 
terminate a process with extreme prejudice. : 
terminate conditional. wiaeSs ea UI ah care 
terminate loop. Geeky Ee ee BS: SN, eee 
terminate process. ......-6s+e8e- 
terminate Switch: oc 6 @ S85 w hee eS 
test: condition command. ......... 
test your knowledge. ....... 6.6408 
text. aide Se: Go ew? es eee se See ae A 
text editor. ta, he doe A.A, igs ier, Se we des Ce ks 
text editor. Rte he: cds er ado! wee al od 
text formatter. ..... A, Pe teeta, te 
text formatting and typesetting. af eee, ae. 8s 
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: 
tgetflag, tgetstr, tgoto, tputs: terminal ea 
tgetnum, tgetflag, tgetstr, (goto, tputs: terminal 
tgetsir, (goto, tputs: terminal independent 
tgolo, tputs: terminal independent operation 
them. compact. uncompact, i. tercan pe 
thesaurus for diction. ........ 
thesaurus for diction. ........0... 
they are doing. es rea ooo a eee 2° ae Aloe 
thFOURN TNE NEL. 4. oa es ee ae ae 
TAFOURN INE NEts: boca ws we Ee ee 

HIMGs: 20 soe ee Be Be ee we 

G2. a eS. Ry So ee hc ee BR BS ee AS 
THE: ee ee Se Ee BS ea we See 
UTIG S55 a SR, ce ee Se ee SR 
PG es ee ee se. Gime we. & tee ee Bs 
time a command. 6s ecw ese Wc Bh eh, a ok 
ume command. Ga ee eae he Merde PS 
time, ftime: get date and time. aye 1. Saloon 
UTE DIONIE: - ae se. oe ee Se SR? BE 
lume: time acommand. ........4.-. 
time: ume command. ........e68. 
tume to ASCII. ctime, localtime, et era Se 
ures. aS AE RC ES ee Bie aa sere ee, 3 
uumes. bp hak ie 3 ey WE nls A RE wy Se 
times: get process times. : 


sinh(3M) 
dumpdir(&) 
ip 1) 

tar(]) 
rewind(1) 
tp(5) 
mt(1) 

tar (1) 
deroff(1) 
tbi(1) 

tc(1) 
tee(]) 
tk) 

call (iC) 
reset(1) 
last()) 
Iseek (2) 

su (1) 
termcap(5) 
lock (1) 
ttyname (3) 
vhangup(2v) 
worms (6) 
termcap(5) 
termcap(3) 
ttys(S) 

tty (4) 

getty (8) 
tset (1) 

tty (1) 

stty (1) 
clear (1) 
script(!) 
tabs(1) 
ttytype (5) 
term (7) 
wait(2) 
wait3 (2)) 
KIC) 
csh(1) 
esh(1) 
exit(2) 
esh(1) 

test (1) 

quiz (6) 
sticky (8) 
ed(1) 
ex(1) 
frnt(1) 
croft (1) 
termcap(3) 
termcap (3) 
termcap(3) 
termcap(3) 
termcap(3) 
compact(1) 
diction(1) 
explain (1) 
w(1) 
netcp(1) 
netipr(1) 
alarm (2) 
at(1) 
shutdown (8) 
Stime (2) 
time (2) 
time (1) 
esh(1) 
time (2) 
profil (2) 
time (1) 
eshil) 
ctime (3) 
times(2) 
utime (2) 
times (2) 


export, login, newgrp, read, readonly, set, shift, 
ctime, localtime, gmtime, asctime, 


ht: 

tm: 

popen, pclose: initiate 1/O 
tsort: 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, 


ptrace: process 
uuencode,uudecode: encode/decode a binary file for 
goto: command 

tr: 

macros. trman: 

oi: Pascal interpreter code 

login, newgrp, read, readonly, set, shift, times, 


trek: 

SiN, COS, tan, asin, acos, atan, atan2: 
7 macros. 

tbl: format tables for nroff or 


deroff: remove nroff, 
vtroff: 
nettroff: 


true, false: provide 
chase: 


ts: 
newtty: summary of the ‘‘new”’ 
greek: graphics for extended 


ttyname, isatty, 


file: determine file 

greek: graphics for extended TT Y-37 
stab: symbol table 

types: primitive system data 

ttytype: data base of terminal 


script: make 

man: macros to 

eqn, neqn, checkea: 

troff, nroff: text formatting and 
getpw: get name from 


newerp, read, readonly, set, shift, times, trap, 
mount, 
mount, 


cat them. compact, 

compact, uncompact, ccat: compress and 
ul: do 

expand, 


up: 


mktemp: make a 


cu: call 

learn: computer aided instruction about 
reboot: 

uuUX: UNIX [0 


times, trap, umask, wait: command language. /exit, 
timezone: convert date and time to ASCII. 

tk: paginator for the Tektronix 4014. 

tm: TM-11/TE-10 magtape interface. 


TM-03/TE-16.TU-45.TU-77 MASSBUS magtape in miertics: 


TM-11/TE-10 magtape interface. 

to/from a process. 

topological sort. ‘ 

touch: update date last modified of a file. 

tp: DEC/mag tape formats. 

tp: manipulate tape archive. 

tputs: terminal independent oer ion routines: 

tr: translate characters. 

trace. 

tranmission via Arai! 

transfer. d 

translate chardciers. a: 3 
translate version 6 manual macros ie: version 7 
translator. 

trap, umask, wait: command: language: 
trek: trekkie game. 

trekkie game. ...... 
trigonometric functions. 


trman: translate version 6 manual n macros ‘to version 


troff. 

troff, nroff: text formatting and typesetting. 
troff, tbl and eqn constructs. 
troff to araster plotter. ........4.. 
troff to the phototypesetter over the network. 
true, false: provide truth values. 

truth values. , 

Try to escape to killer robots. 

ts: TS-1] magtape interface. 

TS-11 magtape interface. 

tset: set terminal modes. 

tsort: topological sort. 

tty driver. 

tty: general jecrainal snleraces, 

tty: get terminal name. 

TTY -37 type-box. : : 
ttyname, isatty, ttyslot: ee name tot: a iepminal. 
ttys: terminal initialization data. 

ttyslot: find name of a terminal. 
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type. 
type-box. 


types. 


lypes. 


types by port. 5 ; 
types: primitive system daa pes: 
typescript of terminal session. 
typeset manual. 

typeset mathematics. 

typesetting. fi eo be oe Be 
uid. oe AO es Dw aC ae tes RE eS “Ge ae BR 

ul: do Gndeninine: ; 

umask: change or display file eadon miask. 

umask: set file creation mode mask. 

umask, wait: command language. /export, login, 
umount: mount and dismount file system. 

umount: mount or remove file system. 

unalias: remove aliases. 

uncompact, ccat: compress and eacemieress files: and 
uncompress files, and cat them. 

underlining. ’ ' 
unexpand: expand tabs to paces: and vice versa. 
ungetc: push character back into input stream. 
unhash: discard command hash table. 

unibus storage module controller/drives. 

uniq: report repeated lines in a file. 
unique hle name. : 

units: conversion program. 

UNIX. ete 

UNIX. 

UNIX bootstrapping procedures. 
umx command execution. 


s% 


Sexi: export, 


ttytype: data base of terminal types by port. ae eee 


¢ 


Permuted Index 


sh(1) 
ctime (3) 
tk (1) 
tm (4) 
ht(4) 
tm (4) 
popen (3S) 
tsort(]) 
touch(1) 
tp(5) 
tp(1) 
termcap(3) 
ir(1) 
ptrace (2) 


uuencode(1C) 


esh(1) 
tr(1) 
trman(]) 
pi()) 

sh(]) 

trek (6) 
trek (6) 
sin(3M) 
trman(1) 
tbi(1) 
troff(1) 
deroff(1) 
vtroff (1) 
nettrofi (1) 
true(1) 
true (1) 
chase (6) 
ts(4) 

ts(4) 
tset(1) 
tsort(1) 
newtty (4) 
tty (4) 

tty (1) 
greek (7) 
ttyname (3) 
ttys(S) 
ttyname (3) 
ttytype (S$) 
file(1) 
greek (7) 
stab(5) 
types (5) 
ttytype(S) 
types (5) 
script (1) 
man(7) 
eqn(1) 
troff (1) 
getpw (3) 
ul (1) 
esh(1) 
umask (2) 
sh(]) 
mount(8) 
mount(2) 
esh(1) 
compact(]) 
compact(]) 
ul (1) 
expand (1) 
ungetc (3S) 
csh(}} 
up(4) 
uniq(1) 
mktemp(3) 
units (1) 
cu(IC) 
learn(1) 
reboot (8) 
uux(1C) 


Permuted Index 


uucp, uulog: unix to 

vfontinfo: inspect and print out information about 
mit: 

analyze: Virtual 

uUX: 

uucp, uulog: 


rm, rmdir: remove 


uptime: show how long system has been 
touch: 


sync: 
sync: 
update: periodically 


du: summarize disk 

netipr: 

what: show what versions of object modules were 
chfn: change full name of 

login: login new 

write: write to another 

setuid, setgid: set 


getuid, getgid, geteuid, getegid: get 
environ: 

whoami: print effective current 

: | _ gu: substitute 
finger: 

wtmp: 


adduser: procedure for adding new 
mail: send or receive mail among 
wall: write to all 

Jast: indicate last logins of 


users: compact list of 
vtimes: get information about resource 


uuclean: 


uuencode: format of an encoded 


tranmission via mail. 
uUCcp, 


abs: integer absolute 
fabs, floor, ceil: absolute 
getenv: 

set: change 


true, false: provide truth 


set: change value of shell 
varargs: 
setenv: set 
@: arithmetic on shell 
unset: discard shell 
unsetenv: remove environment 
| cons: 
assert: program 
lint: a C program 
expand, unexpand: expand tabs to spaces, and vice 
vfont: font formats for the Benson- Varian or 
vp. 
trman: translate 
trman: translate version 6 manual macros to 
hangman: Computer 
file. what: show what 
8 


unix copy. 
unix fonts. ae 
UNIX magtape interface. a 
UNIX postmortem crash analyzer. 
unix tO umIxX Command execution. 
unIX tO UNIX COpy. 

unlimit: remove resource timitiations. 
(unlink) files. ; 

unlink: remove directory entry. 

unset: discard shell variables. 
unsetenv: remove environment variables. 
up. . 
up: unmibus storage module controller/drives. d 
update date last modified of a file. ......... 
update: periodically update the super biock. .. 
update super-block. a ee OS er 
update the super block. ...... 
update the super block. : ‘ 
uptime: show how long system has ‘been up. 
usage. ae F 
use a remote lineprinter through (RENEE. ee ee SS 
used to construct a file. 
user. 
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user. 
user and group ID. 
user and group identity. 
user environment. 
user id. 
user id temporarily. 
user information lookup program. 
user login history. 
users. 
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users. 
users and teletypes. 
users: compact list of users who are on the system. 
users who are on the system. 
utilization. 
utime: set file times. 
utmp, wimp: login records. 
uuciean: uucp spool directory clean-up. 
uucp spool directory clean-up. 
uucp, uulog: unix to uMix copy. Bub? ae th 
uudiff: directory comparison between machines. 
uuencode file. 
uuencode: format of an encoded iuencode file 
uuencode, uudecode: encode/decode a binary file for 
uulog: umix lO UNIX COpy. ; 

uusend: send a file to a remote ey 
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uux: umix tO uMIX COMmand execution. ........ 
va: Benson- Varian interface. te te ae 

vadvise: give advice to paging system. ....... 
valloc: aligned memory allocator. ........4.. 
Wane: 2 as ee ie en OR, a es ee Us Se Se 
value, floor, ceiling functions. 

value for environment name. ....... .e8e-s 
value of shell variable. ....... 

values. ac hge ti dc Be a St 
varargs: variable argument list. i hit. Ge a 
variable. ...+«-e«.s-s. P BS Sa Te SS ee 
variable argument list. ..... be <A awe VED Sap eer ee Y 
variable in environment. ......e.e. : 
variables. ......see-. 

variables. . . 2. « «© « «© «6 « Stee Sat ae odes ak eee 
VAPIADIOS:. a: 6 wend te Bie we ee ee eee ae SB 
VAX-11 console interface. ......2.4... 
verification. ....... eS oe 

verifier, ..... a ee ee dda: Bee: ha Jah Ge we cata 
VOISA® -%. ae ine. Hy Mee See he ee na ess SR 
VGISAIRG... hn ew a ee et EE Se a 
Versatec interface. . . . 16 6 1 eee ee ee 


version 6 manual macros to version 7 macros. 
version 7 macros. ......4.-. 


version of the game hangman. P . 
versions of object modules were used to donsiract: a 
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uucp(1C) 
vfontinfo(1) 
mt(4) 
analyze (8) 
uux (1C) 
uucp(1C) 
csh(1) 
rm(1) 
unlink (2) 
esh(1) 
esh(1) 
uptime (1) 
up(4) 

touch (1) 
update (8) 
sync(2) 

sync (8) 
update (8) 
uptime (1) 
du(]) 
netipr (1) 
what(1) 
chfn(1) 
esh(1) 

write (1) 
setuid (2) 
getuid (2) 
environ (5) 
whoami(]) 
su(l) 
finger(1!) 
wtmp(5) 
adduser (8) 
binmail (1) 
wall(1) 
last(1) 

users (1) 
users (1) 
vtimes(Zv) 
utime (2) 
utmnp(5) 
uuclean(1C) 
uuclean(1C) 
uucp(1C) 
uudiff(1C) 
uuencode(5) 
uuencode (5) 
uuencode (IC) 
uucp(1C) 
uusend(1C) 
uux(1C) 

va (4) 
vadvise (2v) 
valloc(3) 
abs (3) 
floor (3M) 
getenv (3) 
esh(1) 
true (1) 
varargs (3) 
csh(]) 
varargs(3) 
esh(1) 
esh(1) 
esh(1) 
csh(1) 

cons (4) 
assert(3x) 
lint(1) 
expand(1) 
vfont(5) 

vp (4) 
trman(1) 
trman(1) 
hangman(6) 
what(1) 


Versatec. 
unix fonts. 
efficient way. 


terminal. 

vipw: edit the password file with 

on ex. 

encode/ decode a binary file for tranmission 
expand, unexpand: expand tabs to spaces, and 
more, page: file perusal filter for crt 


vfork: spawn new process in a 
vmstat: report 

analyze: 

vread: read 

vhangup: 

vwrite: write 

vi: screen oriented 
consumption. 


filsys, flblk, ino: format of file system 


information. 
vpr, vprm, 
spooler. 

vpr, yprm, vpq, 
vpr, 


paging/swapping. 


read, readonly, set, shift, times, trap, umask, 
wait: 

wait: 

wait3: 


spawn new process in a virtual memory efficient 


what: show what versions of object modules 
whatis: describe 

see: see 

crash: 

used to construct a file. 

w: who is on and 

construct a file. what: show 


crash: what happens 

leave: remind you 

program. 

paths (csAonly). 

exec, exit, export, login,/ sh, for, case, if, 


break: exit 

users: compact list of users 

from: 

We 

who: 

biff: be notified if mail arrives and 


fold: fold long lines for finite 

we: 

getc, getchar, fgetc, getw: get character or 
putc, puichar, fputc, putw: put character or 
diction,explain: print 

diction.explain: print 

cd: change 

chdir: change current 

pwd: 

worm: Play the growing 


vfont: font formats for the Benson-Varian or 


vfontinfo: inspect and print out information about 


vfork: spawn new process in a virtual memory 
vgrind: grind nice listings of programs. 
vhangup: virtually ““hangup”’ the current control 
vi: screen oriented (visual) display editor based 
via mail. uuencode.,uudecode: 
vice versa. 
viewing. ‘ 
vipw: edit the saseword file oe Vi. 
virtual memory efficient way. 
virtual memory statistics. . 
Virtual UNIX postmortem crash analyzer. 
virtually. iin See ie eh Bes cs Se was FS ne ae ee od 
virtually ‘““hangup’’ the current control terminal. 
(virtually) to file. 

(visual) display editor eased on ex. 
vilimit: control maximum system resource 
vmstat: report virtual memory statistics. 
volume. : 

vp: Versatec interface: 
vpac: print raster orinter/oloter accounting 
vpq, Vprint: raster printer/plotter spooler. 
vor, vprm, vpq, vprint: raster printer/plotter 
vprint: raster printer/plotter spooler. 
vprm, vpq, vprint: raster printer/plotter spooler. 
vread: read virtually. : 
vswapon: add a swap device for tetleaved: 


viimes: get information about resource utilization. 


vtroff: troff to a raster plotter. bs a 
vwrite: write (virtually) to file. a ah Gets 
w: who is on and what they are doing. 
wait: await completion of process. 


wait: command language. /export, login, aeaenn. 


wait for background processes to complete. 
wait for process to terminate. 

wait for process to terminate. 

wait: wait for background processes to complete: 
wait: wait for process to terminate. 

wait3: wait for process to terminate. 

wall: write to all users. 

way. vfork: ..... 

we: word count. eo <a 

were used to construct a file. 

what a command is. 

what a file has in it. . 

what happens when the syateni crashes: 


what: show what versions of ei modules were 


what they are doing. So , ee & 

what versions of object modules : were used to 
whatis: describe what a command is. 

when the system crashes... 

when you have to leave. 


whereis: locate source, binary, ee or anal for 


which: locate a program file including aliases and 
while, :, ., break, continue, cd, eval, 
while: repeat commands conditionally. 
while/foreach loop. 

who are on the system. 

who is my mail from?. 

who is on and what they are doing. 

who is on the system. 

who it is from. 

who: who is on the Vien ; 
whoami: print effective current user aa 
width output device. 2 ee 
WOrG COUNT: is. & seve aioe, oes Ee 
word from stream. 

word on a Stream. 

wordy sentences: thesaurus for acon. 
wordy sentences; thesaurus for diction. 
working directory. 

working directory. 

working directory name. 

worm game. 
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Permuted Index 


vfont(S) 
vfontinfo(1) 
vfork (2v) 
verind(1) 
vhangup(2v) 
vipw (8) 
vill) 
uuencode(1C) 
expand(1) 
more(1) 
vipw (8) 
vfork (2v) 
vmstat(]) 
analyze(8) 
vread(2v) 
vhangup(2v) 
vwrite (2v) 
vi(l) 
vlimit(2v) 
vmstat(]) 
Ailsys(5) 
vp(4) 

vpac (8) 
vpr(1) 
vpr(1) 
vpr(1) 
vpr(1) 

vread (2v) 
vswapon (2v) 
vumes(2v) 
viroft (1) 
vwrite(2v) 
wil) 

wait(1) 

sh(1) 

esh(1) 


7 wait(2) 


wait3 (2j) 
esh(1) 
wait(2) 
wait3(2j) 
wall(1) 
vfork (2v) 
we(]) 
what(1) 
whats (1) 
see (1) 
crash(8) 
what(1) 
w(1) 
what(1) 
whatis(1) 
crash(8) 
leave (1) 
whereis(1) 
which(]) 
sh(1) 
esht1) 
csh(1) 
users(1) 
from(1) 
w(1) 

who (1) 


bit) 


who (1) 
whoami(1) 
foid(1) 
we(l) 
getc(3S) 
putc(3S) 
diction(]) 
explain (1) 
ed (1) 
chdir(2) 
pwd(1) 
worm (6) 


Permuted Index 


worms: animate 
write: 

wall: 

write: 

vwrite: 


open: open for reading or 
utmp, 


xsend, 


shared strings. 
j0. jl, jn, 

j0, jt, jn, yO, 
eyacc: modified 


j0, j1, in, yO, yl, 
leave: remind you when 
leave: remind 


worm: Play the growing worm game. 
worms: animate worms on a display terminal. 


worms on a display terminal. 
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write on a file. 
write to all users. 
write to another user. 
write (virtually) to file. 
write: write on a file. 
write: write to another user. 
writing. 
wimp: login records. 
wtmp: user login history. 
wump: the game of hunt-the-wumpus. 
xget, enroll: secret mail. .. . 
xsend, xget, enroll: secret mail. 
xStr: extract strings from C programs to implement 
y0, yl, yn: bessel functions. 
yl, yn: bessel functions. 
yacc allowing much improved error recovery. 
yacc: yet another compiler-compiler. 
yes: be repetitively affirmative. 
yn: bessel functions. 
you have to leave. 
you when you have to leave. 
zork: the game of dungeon. 


© ee € e@ 8 e® ®  @®  &®  e@ e@ e e« e® e oe «6 
ee e® @ e# « 

e e® @e@ @® @© @® @® ® e6© ®  ® @¢ oe oe «6 

e ee 8&8@° e® 8® ® e®© e e® @® ® es @#® @ @¢@ 
es ¢© ee &® «© @ ® ® @® @ @®© @ &@® ¢ o@ 
eo @ @¢ je@ j@© © e® e 6®  @® e@® @ @ 
¢& se @® oe @ @ @® 6 @ @ 
ee 6 @® 8® 8» @ @ @® e® e@ 8 @® &® e® e @ 


e 8@®8 8@© @  @ @ @ @®@  @  @® ee  @ 
* e @® @  @ @®  @ 
2 @ je e@® e© e® @®© e@ ® @ @ 
© ee @ @e@® @ @# @e@ @ e® @ @® & 
es oe e® ® @ 
oo oe ee @® 
ee e e8® e e@® @® @ e8 @ 
oo ee @ je e® ® @® ® @®  @® 6 

es @ e@® @  @ @  @ @® @ e@ @ j®© @®  @ 8 £4 
ee @®& @ @ @® @  @®  &®  #¢© @® oe e@® ® ® @ @® .@ 
ee @e@ @® ® j@®  j@®  @  &®  @®  @  @ 6 


- liv - 


worm (6) 
worms (6) 


worms (6) 


write (2) 
wall (1) 


write (1) 


vwrite (2v) 
write (2) 
write(1) 
open (2) 
utmp (5) 
wimp(5) 
wump(6) 
xsend (1) 
xsend (1) 
xstr(1) 


j0(3M) 

leave(]) 
leave(1) 
zork (6) 
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NAME 
intro — introduction to commands 


DESCRIPTION 
This section describes publicly accessible commands in alphabetic order. Certain distinctions of 
purpose are made in the headings: 


(1) Commands of general utility. 
(1C) Commands for communication with other systems. 
(1G) Commands used primarily for graphics and computer-aided design. 


N.B.: Commands related to system maintenance, which appeared in section 1, distinguished by 
(1M), in previous versions of the manual have been moved to section 8, as they are of little 
interest to most users. 


The word ‘VAX-11° at the foot of a page means that some or all of the description applies only 
to the implementation for the Digital Equipment Corporation VAX-1]. Pages added or 
changed between the distribution of UNIX/32V and the Berkeley Distribution indicate ‘3rd 
Berkeley Distribution’ or ‘4th Berkeley Distribution’ at the lower left, as appropriate. 


SEE ALSO 
Section (6) for computer games, section (8) for system maintenance commands. 


How to get Started, in the Introduction. 


DIAGNOSTICS 

Upon termination each command returns two bytes of status, one supplied by the system giving 
the cause for termination, and (in the case of ‘normal’ termination) one supplied by the pro- 
gram, see wait and exit(2). The former byte is 0 for normal termination, the latter is cus- 
tomarily 0 for successful execution, nonzero to indicate troubles such as erroneous parameters, 
bad or inaccessible data, or other inability to cope with the task at hand. It ts called variously 
‘exit code’, ‘exit status’ or ‘return code’, and is described only where special conventions are 
involved. 
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NAME 
adb — debugger 


SYNOPSIS 
adb [—w] [ objfil [ corfil ] ] 
DESCRIPTION 


Adb is a general purpose debugging program. It may be used to examine files and to provide a 
controlled environment for the execution of UNIX programs. 


Objfilis normally an executable program file, preferably containing a symbol tabie: if not then 
the symbolic features of adb cannot be used although the file can still be examined. The 
default for odjflis a.out. Corfil is assumed to be a core image file produced after executing 
objfit the default for corfilis core. , 


Requests to adb are read from the standard input and responses are to the standard output. If 
the —w flag is present then both odjf/and corfilare created if necessary and opened for reading 
and writing so that files can be modified using adb. Adb ignores QUIT; INTERRUPT causes 
return to the next add command. , 


In general requests to adbare of the form 
[ address] [, count] [ command] [;] 


If address is present then doris set to address. Initially dotis set to 0. For most commands 
count specifies how many times the command will be executed. The default countis 1. Address 
and countare expressions. 


The interpretation of an address depends on the context it is used in. If a subprocess is being 
debugged then addresses are interpreted in the usual way in the address space of the subpro- 
cess. If the operating system is being debugged either post-mortem or using the special file 
/dev/kmem to interactive examine and/or modify memory the maps are set to map the kernel 
virtual addresses which start at 0x80000000. For further details of address mapping see 
ADDRESSES. 


EXPRESSIONS 
The value of doz. 


+ The value of dotincremented by the current increment. 


me 


The value of dordecremented by the current increment. 
: The last address typed. 


integer A number. The prefixes 0o and 00 (‘‘zero oh’’) force interpretation in octal radix; the 
prefixes Ot and OT force interpretation in decimal radix; the prefixes Ox and OX force 
interpretation in hexadecimal radix. Thus 0020 = 0t16 = Oxl0 = sixteen. If no 
prefix appears, then the default radix is used; see the $d command. The default radix is 
initially hexadecimal. The hexadecimal digits are 0123456789abcdefABCDEF with the 
obvious values. Note that a hexadecimal number whose most significant digit would 
otherwise be an alphabetic character must have a Ox (or OX) prefix (or a leading zero if 
the default radix is hexadecimal). 


integer. fraction 
A 32 bit floating point number. 


“cccc’ The ASCII value of up to 4 characters. \ may be used to escape a’. 


< name . 
The value of name, which is either a variable name or a register name. Adb maintains a 
number of variables (see VARIABLES) named by single letters or digits. If mame is a 
register name then the value of the register is obtained from the systern header in 
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corfil. The register names are those printed by the $r command. 


symbol A symbolis a sequence of upper or lower case letters, underscores or digits, not starting 
with a digit. The value of the symbdolis taken from the symbol table in odjfil. An ini- 
tial _ or ~ will be prepended to symbolif needed. 


_ symbol 


In C, the ‘true name’ of an external symbol begins with _. It may be necessary to utter 
this name to disinguish it from internal or hidden variables of a program. 


routine.name 


The address of the variable name in the specified C routine. Both routine and name are 
symbols. If name is omitted the value is the address of the most recently activated C 
stack frame corresponding to routine. (This form is currently broken on the VAX: local 
variables can be examined only with sdb(1).) 


(exp) The value of the expression exp. 

Monadic operators 

«exp The contents of the location addressed by expin corfil. 
@exp The contents of the location addressed by expin odjfil 
—exp Integer negation. 

“exp  Bitwise complement. 

#exp Logical negation. | 

Dyadic operators are left associative and are less binding than monadic operators. 
el+e2 Integer addition. 

el—e2 Integer subtraction. 

el.e2 Integer multiplication. 

el%e2 Integer division. 

el&e2 Bitwise conjunction. 

elle2 Bitwise disjunction. 

el#e2 Elrounded up to the next multiple of e2. 


COMMANDS | 
Most commands consist of a verb followed by a modifier or list of modifiers. The following 


verbs are available. (The commands ‘?’ and ‘/’ may be followed by ‘.’; see ADDRESSES for 
further details.) | 


of Locations starting at addressin objfilare printed according to the format f doris incre- 
mented by the sum of the increments for each format letter (q.v.). 
lf Locations starting at address in corfil are printed according to the format fand dort is 


incremented as for ‘?’. 


= f The value of address itself is printed in the styles indicated by the format f (For i for- 
mat ‘?’ is printed for the parts of the instruction that reference subsequent words.) 


A formatconsists of one or more characters that specify a style of printing. Each format charac- 
ter may be preceded by a decimal integer that is a repeat count for the format character. While 
stepping through a format dotis incremented by the amount given for each format letter. If no 
format is given then the last format is used. The format letters available are as follows. 


0 2 Print 2 bytes in octal. All octal numbers output by adbare preceded by 0. 
O4 ~~ ~Print 4 bytes in octal. | 
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Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. 

Print double floating point. 

Print the addressed byte in octal. 

Print the addressed character. | 

Print the addressed character using the standard escape convention where con- 
trol characters are printed as “X and the delete character is printed as °?. 


Cc) — ie? de ae pe oe OF 
pat ot bet OO 2 fa AD RD & HO PP AD 


s n_ Print the addressed characters until a zero character is reached. 

Sn Print a string using the “X escape convention (see C above). mis the length of 
the string including its zero terminator. 

Y 4 ~~ s*~Print 4 bytes in date format (see crime(3)). 

in Print as VAX instructions. mis the number of bytes occupied by the instruc- 


tion. This style of printing causes variables 1 and 2 to be set to the offset parts 
of the source and destination respectively. 

a Q Print the value of doin symbolic form. Symbois are checked to ensure that 
they have an appropriate type as indicated below. 


/ local or global data symbol 
? — Jocal or global text symbol 
« local or global absolute symbol 
4 


Print the addressed value in symbolic form using the same rules for symbol 

lookup as & 

t 0 | When preceded by an integer tabs to the next appropriate tab stop. For exam- 
ple, 8t moves to the next 8-space tab stop. 

r 0. Print a space. 

nO Print a newline. 

*,. QO Print the enclosed string. 

7 Doris decremented by the current increment. Nothing is printed. 

Dotis incremented by 1. Nothing is printed. 

Doris decrermented by 1. Nothing is printed. 


i + 


newline 
Repeat the previous command with a counrof 1. 


[?/]l value mask 
Words starting at dor are masked with mask and compared with value until a match is 
found. If L is used then the match is for 4 bytes at a time instead of 2. If no match is 
found then doris unchanged: otherwise doris set to the matched location. If mask is 
omitted then ~1 is used. 


[?/lw value ... 
Write the 2-byte value into the addressed location. If the command is W, write 4 bytes. 
Odd addresses are not allowed when writing to the subprocess address space. 

(?/Jm b/ el f1{?/ 
New values for (4/, e/, /1) are recorded. If less than three expressions are given then 
the remaining map parameters are left unchanged. If the ‘?’ or ‘/’ is followed by ‘.' 
then the second segment (452, e2,/2) of the mapping is changed. If the list is 
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terminated by ‘?’ or ‘/’ then the file (odjf/or corfilrespectively) is used for subsequent 
requests. (So that, for example, ‘/m?’ will cause ‘/’ to refer to odjfil) 


> name Doris assigned to the variable or register named. 


: 


3 modifier 


A shell is called to read the rest of the line following ‘!’. 


Miscellaneous commands. The available modjfiers are: 


<f 


<<f 


yam mougqgea 


:modifier 


be 


Read commands from the file f£ If this command is executed in a file, further 
commands in the file are not seen. If fis omitted, the current input stream is 
terminated. If a countis given, and is zero, the command will be ignored. The 
value of the count will be placed in variable 9 before the first command in /is 
executed. 

Similar to < except it can be used in a file of commands without causing the 
file to be closed. Variable 9 is saved during the execution of this command, 
and restored when it completes. There is a (small) finite limit to the number 
of << files that can be open at once. 

Append output to the file £ which is created if it does not exist. If fis omitted, 
output is returned to the terminal. 

Print process id, the signal which caused stoppage or termination, as well as the 
registers as $r. This is the default if modifier is omitted. 

Print the general registers and the instruction addressed by pe Doris set to pe. 

Print all breakpoints and their associated counts and commands. 

C stack backtrace. If address is given then it is taken as the address of the 
current frame (instead of r5). If C is used then the names and (16 bit) values 
of all automatic and static variables are printed for each active function. If 
countis given then only the first count frames are printed. 

Set the default radix to address and report the new value. Note that address is 
interpreted in the (old) current radix. Thus ‘‘103d’’ never changes the default 
radix. To make decimal the default radix, use ‘‘0t10$d’’. 

The names and values of external variables are printed. 

Set the page width for output to address (default 80). 

Set the limit for symbol matches to address (default 255). 

All integers input are regarded as octal. 

Reset integer input as described in EXPRESSIONS. 

Exit from adb. 

Print all non zero variables in octal. 

Print the address map. 


Manage a subprocess. Available modifiers are: 


Set breakpoint at address. The breakpoint is executed count—1 times before 
causing a stop. Each time the breakpoint is encountered the command cis exe- 
cuted. If this command is omitted or sets dot to zero then the breakpoint 
causes a stop. 


Delete breakpoint at address. 


Run odjfl as a subprocess. If address is given explicitly then the program is 
entered at this point; ocherwise the program is entered at its standard entry 
point. count specifies how many breakpoints are to be ignored before stopping. 
Arguments to the subprocess may be supplied on the same line as the com- 
mand. An argument starting with < or > causes the standard input or output 
to be established for the command. All signals are turned on on entry to the 
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subprocess. 


CS The subprocess is continued with signal sc s, see signa/(2). If address is given 
then the subprocess is continued at this address. If no signal is specified then 
the signal that caused the subprocess to stop is sent. Breakpoint skipping is the 
same as for r. 


SS As for c except that the subprocess is single stepped counttimes. If there is no 
current subprocess then o&jfi/is run as a subprocess as for r. In this case no 
Signal can be sent; the remainder of the line is treated as arguments to the sub- 
process. 


k The current subprocess, if any, is terminated. 


VARIABLES 


Adb provides a number of variables. Named variables are set initially by adb but are not used 
subsequently. Numbered variables are reserved for communication as follows. 


0 The last value printed. 

l The last offset part of an instruction source. 

2 The previous value of variable 1. 

9 The count on the last $< or $< < command. 


On entry the following are set from the system header in the corfil If corfildoes not appear to 
be a core file then these values are set from odjfil. 


b The base address of the data segment. 
d The data segrnent size. 
e@ The entry point. 
m The ‘magic’ number (0407, 0410 or 0413). 
S The stack segment size. 
t The text segment size. 
ADDRESSES 


FILES 


The address in a file associated with a written address is determined by a mapping associated 
with that file. Each mapping is represented by two triples (4/, e/, 7) and (62, e2, /2) and the 
file address corresponding to a written address is calculated as follows. 


bl< address<e] => file address™ address+ f1 ~ bl, otherwise, 
b2< address<e2 => file address™ address+ f2—b2, 


otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I 
and D space) the two segments for a file may overlap. If a ? or / is followed by an . then only 
the second triple is used. | 


The initial setting of both mappings is suitable for normal a.out and core files. If either file is 
not of the kind expected then, for that file, 5/7 is set to 0, e/ is set to the maximum file size and 
/1 is set to 0; in this way the whole file can be examined with no address translation. 


So that adb may be used on large files all appropriate values are kept as signed 32 bit integers. 


a.out 
core 


SEE ALSO 


sdb(1), ptrace(2), a.out(5), core(5) 


DIAGNOSTICS 


‘Adb’ when there is no current command or format. Comments about inaccessible files, syntax 
errors, abnormal termination of commands, etc. Exit status is 0, uniess last command failed or 
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returned nonzero Status. 


BUGS 
Local variable addresses and names are recorded in the a.owz file in a format known only to 
sdb(1). 


Use of # for the unary logical negation operator is peculiar. 
There doesn’t seem to be any way to clear all breakpoints. 
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NAME 

api — an apl interpreter 
SYNOPSIS 

apl 
DESCRIPTION 


Api is an APL interpreter. All of the operators are exactly as in api\360. Overstrikes are often 
required, and they work (use ctrl-h). 

Function definition is not what you would expect. Functions are loaded from files. The first 
line of the file is the function header, as you would expect it but with no del. The rest of the 
file is the lines of the function. Lines are numbered, but there are no square brackets with line 
numbers. If you say )READ FILE it will load the function in that file. If you say )EX FILE it 
will put you in the editor to change that file. Upon exit, it will read the file in as though by 
)READ. 

All of the usual operators are available, including domino. Also available are monadic encode 
and epsilon. 


The following ap/ system commands are available. 


JASCII 
changes terminal to accept and print ASCII characters and operators; this is the default. 
If you are stuck in APL mode on an ASCII terminal, ‘"’ is ‘)’ and lowercase letters map 
to uppercase. 

JAPL 
changes terminal to accept and print APL characters. Erase is set to M and kill is set to 
a. 


)DIGITS n 
sets the number of digits displayed to n, from | to 19. 


JFUZZ n 
sets the fuzz to n. 


" JORIGIN n 
sets the origin to n, which should be 1 or 0. 


)WIDTH n 
sets apl’s idea of your terminal’s carriage width. 


JERASE n 
gets rid of function or variable named n. 


YSAVE n 
saves all variables and functions (workspace) in file named n. Workspaces are sensitive 
to changes in api. 


)LOAD a 
gets the workspace in file n (which must have been )SAVE’d.) 


)COPY n 
like })LOAD but variables and functions are not erased. Things in the loaded file take 
precedence over stuff already in. 


JCLEAR 
clears the workspace. 


)DROP n 
deletes file n in your directory, which need not be saved from api. 


JCONTINUE 
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FILES 


exits and saves workspace in file continue which is loaded next time you run api. 
)OFF 
exits apl. 
YREAD no 
reads in a function from file vn. The first line is the header, with no del’s. The full 
APL360 header is accepted. All other lines in the file are lines in the function. Lines 
are implicitly numbered, and transfers are as usual. There are no labels. 
JEDIT a 
runs the editor ed(1) on file n, and then )READ’s the file when you leave the editor. 
JEX n , 
runs the editor ex(1) on file , and then )READ’s the file when you leave the editor. 
)VIn | 
runs the editor wi(1) on file n, and then )READ’s the file when you leave the editor. 
)LIB 
lists out all of the files in the current directory. 
)FNS 
lists out all current functions. 
YVARS 
lists out all current variables. 
)DEBUG 


toggles a debugging switch, which can produce vast amounts of hopelessly cryptic out- 
put. 


apl_ws — temporary workspace file 
continue — continue workspace 


AUTHORS 


BUGS 


Ken Thompson, Ross Harvey, Douglas Lanam 


This program has not been extensively used or tested. 
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ASCII CHAR MNEMONICS 


Re 
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O<,“*qan PTO I* HATTA L? 


57>Oe™ 


Nx <A V]ArSM LCN 


and fe 
minus + 
less than > 
equal to ; 
divide . 
factorial and combinations 2 
less than or equal ge 
not equal om 
epsilon wh 
not (also “~’) tk 
drop At 
circular function al 
maximum (ceiling) fl 
del (not used) .de 
small circle (null) .qd 
right U (not used) SC 
Down U SU 
upside-down del .bv 
encode (rep) .br 
assignment (also ’_’) .Z0 
or nn 
nor lg 
reversal tr 
reverse bar cb 
Slash bar .bb 
grade up .gd 
quote quad .dm 
lamp ib 
execute (not used) fr 
diamond (not used) ot 
locked del (not used) _a 
alias for B’ ait 
alias for “D’ _e 
alias for “F 8% 
alias for “H’ ail 
alias for ‘J’ My 
alias for “L’ mM 
alias for “N’ 0 
alias for ‘P” 2G 
alias for “R’ “iS 
alias for “T Xu 
alias for “V" .__W 
alias for “X° 
alias for “Z 
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times | 
add 
greater than 

comma 

exponential (power) 
deal 

greater than or equal 
omega (not used) 
shape (rho) 

take (also “~’) 

iota 

alpha (not used) 
minimum (floor) 
upside down del 

quad 

left U (not used) 

U (not used) 

decode (base) 

residue (mod) 

goto 

nand 

log 

transpose 

comma bar ( not used) 
blackslash bar 

grade down 

domino 

I-beam 

format(not used) 

out (not used) 

alias for “A’ 

alias for ° 
alias for © 
alias for 
alias for ° 
alias for 
alias for 
alias for 
alias for 
alias for 
alias for 
alias for 
alias for 
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NAME ; 
apropos — locate commands by keyword lookup 
SYNOPSIS 
apropos Keyword ... 
DESCRIPTION 


Apropos shows which manual sections contain instances of any of the given keywords in their 
title. Each word is considered separately and case of letters is ignored. Words which are part of 
other words are considered thus looking for compile will hit all instances of ‘compiler’ also. 
Try 


apropos password 
and 
apropos editor 


If the line starts ‘name(section) ...” you can do ‘man section name’ to get the documentation 
for it. Try ‘apropos format’ and then ‘man 3s printf’ to get the manual on the subroutine printf 


Apropos is actually just the —k option to the man(2) command. 


FILES 

/usr/lib/whatis data base 
SEE ALSO 

man(1), whatis(1), catman(8) 
AUTHOR 

William Joy 
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ar — archive and library maintainer 


SYNOPSIS 


ar key [ posname ] afile name ... 


DESCRIPTION 


Ar maintains groups of files combined into a single archive file. Its main use is to create and 
update library files as used by the loader. It can be used, though, for any similar purpose. 
N.B: This version of ar uses a ASCII-format archive which is portable among the various 
machines running UNIX. Programs for dealing with older formats are available: see o/d(8). 


Key is one character from the set drqtpmx, optionally concatenated with one or more of 
vuaibcl. Afi/e is the archive file. The names are constituent files in the archive file. The mean- 
ings of the key characters are: 


d 
r 


FILES 


Delete the named files from the archive file. 


Replace the narned files in the archive file. If the optional character u is used with r, 
then only those files with modified dates later than the archive files are replaced. If an 
optional positioning character from the set abi is used, then the posname argument 
must be present and specifies that new files are to be placed after (a) or before (b or i) 
posname. Otherwise new files are placed at the end. 


Quickly append the named files to the end of the archive file. Optional positioning 
characters are invalid. The command does not check whether the added members are 
already in the archive. Useful only to avoid quadratic behavior when creating a large 
archive piece-by-ptece. 

Print a table of contents of the archive file. If no names are given, all files in the 
archive are tabled. If names are given, only those files are tabled. 

Print the named files in the archive. 


Move the named files to the end of the archive. If a positioning character is present, 
then the posname argument must be present and, as in r, specifies where the files are to 
be moved. 


Extract the named files. If no names are given, all files in the archive are extracted. In 
neither case does x alter the archive file. 


Verbose. Under the verbose option, ar gives a file-by-file description of the making of 
a new archive file from the old archive and the constituent files. When used with ¢, it 
gives a long listing of all information about the files. When used with p, it precedes 


~ each file with a name. 


Create. Normally ar will create afile when it needs to. The create option suppresses 
the normal message that is produced when a/flle is created. 


Local. Normally ar places its temporary files in the directory /tmp. This option causes 
them to be placed in the local directory. 


/tmp/v* _ temporaries 


SEE ALSO 


lorder(1), Id(1), ranlib(1), ar(5), arcv(8), old(8) 


BUGS 


If the same file is mentioned twice in an argument list, it may be put in the archive twice. 
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NAME 


DESCRIPTION 
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as — assembler 
SYNOPSIS 
as [—d124][—-L][—-W])[—-V][—-J][—R] [ -t directory ] [ —o objfile ] [ name... ] 


As assembles the named files, or the standard input if no file name is specified. The available 
flags are: 


=—<d 


a 


Specifies the number of bytes to be assembled for offsets which involve forward or 


external references, and which have sizes unspecified in the assembly language. The 
default is —d4. 


Save defined labels beginning with a ‘L’, which are normally discarded to save space in 
the resultant symbol table. The compilers generate such temporary labels. 
Use virtual memory for intermediate storage, rather than a temporary file. 
Do not complain about errors. 


Use long branches to resolve jumps when byte-displacement branches are insufficient. 


This must be used when a compiler-generated assembly contains branches of more than 
32k bytes. 


Make initialized data segments read-only, by concatenating them to the text segments. 
This obviates the need to run editor scripts on assembly code to make initialized data 
read-only and shared. 


Specifies a directory to receive the temporary file, other than the default /tmp. 


All undefined symbols in the assembly are treated as global. 
The output of the assembly is left on the file odjfle, if that is omitted, a.out is used. 


FILES 
/tmp/as* default temporary file 
a.out default resultant object file 
SEE ALSO 


BUGS 


Id(1), nm(1), adb(1), sdb(1), a.out(5) 

Auxiliary documentation Assembler Reference Manual. 
AUTHORS 
John F. Reiser 
Robert R. Henry 


—J should be eliminated; the assembler should automatically choose among byte, word and 
long branches. 
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NAME 
at — execute commands at a later time 


SYNOPSIS 
at time [ day ] [ file ] 


DESCRIPTION 
At squirrels away a copy of the named file (standard input default) to be used as input to sh(1) 
(or csh(1) if you normally use it) at a specified later time. A cd command to the current direc- 
tory is inserted at the beginning, followed by assignments to all environment variables (except- 
ing the variable TERMCAP, which is useless in this context.) When the script is run, it uses 
the user and group ID of the creator of the copy file. 


The time is 1 to 4 digits, with an optional following ‘A’, ‘P’, ‘N’ or ‘M’ for AM, PM, noon or 
midnight. One and two digit numbers are taken to be hours, three and four digits to be hours 
and minutes. If no letters follow the digits, a 24 hour clock time is understood. 


The optional day is either (1) a month name followed by a day number, or (2) a day of the 
week; if the word ‘week’ follows invocation is moved seven days further off. Names of months 
and days may be recognizably truncated. Examples of legitimate commands are 


at 8am jan 24 
at 1530 fr week 


At programs are executed by periodic execution of the command /usr/lib/atrun from cron(8). 
The granularity of at depends upon how often a/run is executed. 


Standard output or error output is lost unless redirected. 
FILES 
/usr/lib/atrun executor (run by cron(8)). 


in /ust/ spool /at: 


yy.ddd. hhhh.°* activity for year yy, day dd, hour hhhh. 
_ jasttiumedone last Ahhh 
past | activities in progress 
SEE ALSO | | 
calendar(1), pwd(1), sleep(1), cron(8) 
DIAGNOSTICS 


Complains about various syntax errors and times out of range. 


BUGS 
Due to the granularity of the execution of /usr/lib/atrun, there may be bugs in scheduling things 
almost exactly 24 hours into the future. 
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NAME 
awk -— pattern scanning and processing language 


SYNOPSIS 
awk [ —Fc] [ prog ] [ file] ... 


DESCRIPTION 


Awk scans each input file for lines that match any of a set of patterns specified in prog. With 
each pattern in prog there can be an associated action that will be performed when a line of a 


file matches the pattern. The set of patterns may appear literally as prog, or in a file specified as 
—f file. 


Files are read in order; if there are no files, the standard input is read. The file name ‘—’ 
means the standard input. Each line is matched against the pattern portion of every pattern- 
action statement; the associated action is performed for each matched pattern. 


An input line is made up of fields separated by white space. (This default can be changed by 
using FS, vide infra.) The fields are denoted $1, $2, ... ; $0 refers to the entire line. 


A pattern-action statement has the form 
pattern ( action } 
A missing { action } means print the line; a missing pattern always matches. 
An action is a sequence of statements. A statement can be one of the following: 


if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 
break 

continue 

{ { statement ] ... } 

variable = expression 

print { expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 
next # skip remaining patterns on this input line 
exit # skip the rest of the input 


Statements are terminated by semicolons, newlines or right braces. An empty expression-list 
stands for the whole line. Expressions take on string or numeric values as appropriate, and are 
built using the operators +, —, *, /, %, and concatenation (indicated by a blank). The C 
operators ++, -——-, +=, —=, *=, /™, and %== are also available in expressions. Variables 
may be scalars, array elements (denoted x[i]) or fields. Variables are initialized to the null 
string. Array subscripts may be any string, not necessarily numeric; this allows for a form of 
associative memory. String constants are quoted ”...”. 


The print statement prints its arguments on the standard output (or on a file if >/ile is present), 
separated by the current output fleld separator, and terminated by the output record separator. 
The printf statement formats its expression list according to the format (see print/(3)). 


The built-in function /ength returns the length of its argument taken as a String, or of the whole 
line if no argument. There are also built-in functions exp, log, sqrt, and int. The last truncates 
its argument to an integer. subsir(s, m, n) returns the n-character substring of s that begins at 
position m. The function sprini/(/mt, expr, expr, ...) formats the expressions according to the 
prinif(3) format given by fmr and returns the resulting string. 


Patterns. are arbitrary Boolean combinations (!, |], &&, and parentheses) of regular expressions 
and relational expressions. Regular expressions must be surrounded by slashes and are as in 
egrep. Isolated regular expressions in a pattern apply to the entire line. Regular expressions 
may also occur in relational expressions. 
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A pattern may consist of two patterns separated by a comma; in this case, the action is per- 
formed for all lines between an occurrence of the first pattern and the next occurrence of the 
second. 


A relational expression is one of the following: 
expression matchop regular-expression 
expression relop expression 


where a relop is any of the six relational operators in C, and a matchop is either ~ (for contains) 
or !~ (for does not contain). A conditional is an arithmetic expression, a relational expression, 
or a Boolean combination of these. 


The special patterns BEGIN and END may be used to capture control before the first input line 
is read and after the last. BEGIN must be the first pattern, END the last. 


A single character c may be used to separate the fields by starting the program with 
BEGIN { FS = "c" } 
or by using the —Fc option. 


Other variable names with special meanings include NF, the number of fields in the current 
record, NR, the ordinal number of the current record; FILENAME, the name of the current 
input file; OFS, the output field separator (default blank); ORS, the output record separator 
(default newline); and OFMT, the output format for numbers (default "%.6g"). 


EXAMPLES 


Print lines longer than 72 characters: 
length > 72 
Print first two fields in opposite order: 
{ print $2, $1 } 
Add up first column, print sum and average: 


{s += $] } 
END { print "sum is", s, ” average is”, s/NR }- 


Print fields in reverse order: 
(for (i = NF;i > 0; ——i) print $i } 

Print all lines between start/stop pairs: 
/start/, /stop/ 

Print all lines whose first field is different from previous one: 
$1 != prev { print; prev = $1 } 


SEE ALSO 


BUGS 


lex(1), sed(1) 
A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk — a pattern scanning and processing 
language 


There are no explicit conversions between numbers and strings. To force an expression to be 
treated as a number add 0 to it; to force it to be treated as a string concatenate ™ to it. 
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NAME 

basename — strip filename affixes 
SYNOPSIS 

basename string [ suffix ] 
DESCRIPTION 


Basename deletes any prefix ending in ‘/’ and the suffix, if present in string, from siring, and 
prints the result on the standard output. It is normally used inside substitution marks °° in 
shell procedures. 


This shell procedure invoked with the argument /usr/src/cmd/cat.c compiles the named file and 
moves the output to cat in the current directory: 


ce $1 
mv a.out ‘basename $1 .c 


SEE ALSO 
sh(1) 
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NAME 

be — arbitrary-precision arithmetic language 
SYNOPSIS 

be [ —c] [ ~—1] [ file ... ] 
DESCRIPTION 


Bc is an interactive processor for a language which resembles C but provides unlimited preci- 
sion arithmetic. It takes input from any files given, then reads the standard input. The -! 
argument stands for the name of an arbitrary precision math library. The syntax for dc pro- 
grams is as follows, L means letter a-z, E means expression, S means statement. 


Comments 
are enclosed in /* and ¢/. 


Names 
simple variables: L 
array elements: L [ E ] 
The words ‘ibase’, ‘obase’, and ‘scale’ 


Other operands 
arbitrarily long numbers with optional sign and decimal point. 
(E) 
sqrt (E ) 
length (E) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
Se ee 


Operators 
+ — = / % ~* (% is remainder, ~ is power) 
++ -=— (prefix and postfix; apply to names) 
a= <= >= != < > 


a - oe —=ms ome {ae om * me 


Statements 
E 
(S;..;8] 
if(E)S 
while (E) S 
for (E,;E;,E)S 
null statement 
break 
quit 
Function definitions 
define L (L,...,L) { 
auto L, ..., L 
8S; ..5 
return ( E ) 


Functions in ~I math library 
s(x) sine 
c(x) cosine 
e(x) exponential 
I(x) — log 
a(x) arctangent 
j{n,x) Bessel function 
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All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the main operator is an assign- 
ment. Either semicolons or newlines may separate statements. Assignment to scale influences 
the number of digits to be retained on arithmetic operations in the manner of dc(1). Assign- 
ments to ibase or obase set the input and output number radix respectively. 


The same letter may be used as an array, a function, and a simple variable simultaneously. Al! 
variables are global to the program. ‘Auto’ variables are pushed down during function calls. 
When using arrays as function arguments or defining them as automatic variables empty square 
brackets must follow the array name. 

For example 


scale = 20 
define e(x) { 
auto a, b,c, 1, $ 
a= | 
b= | 
s =] 
for(im@ 1; l= =]; i++){ 
a ™ ax 
b = bei 
c ™@ a/b 
if(c == Q) return (s) 
s ™=stc 


defines a function to compute an approximate value of the exponential function and 
for(im=1; i< = 10; i++) ei) 
prints approximate values of the exponential function of the first ten integers. 
' Bc is actually a preprocessor for de{1), which it invokes automatically, unless the —¢ (compile 
only) option is present. In this case the dc input is sent to the standard output instead. 


FILES 
/usr/lib/lib.b mathematical library 
de(1) desk calculator proper 


SEE ALSO 

de (1) 

L. L. Cherry and R. Morris, BC — An arbitrary precision desk-calculator language 
BUGS 

No &&, ||, or '! operators. 

For statement must have all three E’s. 

Quitis interpreted when read, not when executed. 
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NAME 

biff — be notified if mail arrives and who it is from 
SYNOPSIS 

biff [ yn ] 


DESCRIPTION 


Biff informs the system whether you want to be notified when mail arrives during the current 
terminal session. The command 


biff y 
enables notification; the command 
biff n 
disables it. When mail notification is enabled, the header and first few lines of the message will 


be printed on your screen whenever mail arrives. A ‘“‘biff y’’ command is often included in the 
file ./Jogin or .profile to be executed at each login. 


Biff operates asynchronously. For synchronous notification use the MAIL variable of sh(1) or 
the mail variable of csh(1). 


SEE ALSO 
esh(1), sh(1), mail(1), mail (4) 


BUGS 


4th Berkeley Distribution 1-20 


BINMAIL (1) UNIX Programmer’s Manual BINMAIL (1) 


NAME 

mail — send or receive mail among users 
SYNOPSIS : 

/bin/mail [ + ] [ —i] [ person ] ... 

/bin/mail [ +] [ -i] —f file 
DESCRIPTION 


Note: This is one of two mailers with the name mail. The default mail command is described in 
. mail(1), and its binary is in the directory /usr/ucbd. 


Mail with no argument prints a user’s mail, message-by-message, in last-in, first-out order; the 
optional argument + causes first-in, first-out order. For each message, it reads a line from the 
Standard input to direct disposition of the message. 


newline 
Go on to next message. 
d Delete message and go on to the next. 
p Print message again. 
_ Go back to previous message. 


s [file]... 


Save the message in the named files (‘mbox’ default). 
w [ file | ... | 

Save the message, without a header, in the named files (‘mbox’ default). 
m [ person } ... 

Mail the message to the named persons (yourself is default). 


EOT (control-D) 
Put unexamined mail back in the mailbox and stop. 


q Same as EQOT. 


lcommand 
Escape to the Shell to do command. 


R 


Print a command summary. 


An interrupt normally causes termination of the command; the mail file is unchanged. The 
optional argument —i causes mai/to continue after interrupts. 


When persons are named, mail takes the standard input up to an end-of-file (or a line with just 
‘’) and adds it to each person’s ‘mail’ file. The message is preceded by the sender’s name and a 
postmark. Lines that look like postmarks are prepended with ‘>’. A person is usually a user 
name recognized by login(1). To denote a recipient on a remote system, prefix person by the 
system name and exclamation mark (see wucp(1)). 


The —f option causes the named file, e.g. ‘mbox’, to be printed as if it were the mail file. 
When a user logs in he is informed of the presence of mail. 


FILES 
/etc/passwd to identify sender and locate persons 
/usr/spool/mail/* incoming mail for user * 
mbox saved mail 
/tmp/ma* temp file 
/usr/spool/mail/*.lock lock for mail directory 
dead. letter unmailable text 
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SEE ALSO 
mail(1), write(1), uucp(1), uux(1), xsend(1), delivermail (8) 


BUGS 
Race conditions sometimes result in a failure to rernove a lock file. 


Normally anybody can read your mail, unless it is sent by xsend(1). An installation can over- 
come this by making mail a set-user-id command that owns the mail directory. 
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NAME 
cal — print calendar 


SYNOPSIS 
cal [ month ] year 
DESCRIPTION 
Cal prints a calendar for the specified year. If a month is also specified, a calendar just for that 


month is printed. Year can be between | and 9999. The month is a number between 1 and 12. 
The calendar produced is that for England and her colonies. 


Try September 1752. 


BUGS 
The year is always considered to start in January even though this is historically naive. 
Beware that ‘cal 78’ refers to the early Christian era, not the 20th century. 
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NAME 

calendar — reminder service 
SYNOPSIS 

calendar { — ] 
DESCRIPTION 


Calendar consults the file ‘calendar’ in the current directory and prints out lines that contain 
today’s or tomorrow’s date anywhere in the line. Most reasonable month-day dates such as 
‘Dec. 7,’ ‘december 7,’ ‘12/7,’ etc., are recognized, but not ‘7 December’ or ‘7/12’. On week- 
ends ‘tomorrow’ extends through Monday. 


When an argument is present, calendar does its job for every user who has a file ‘calendar’ in 
his login directory and sends him any positive results by mai/(1). Normally this is done daily in 
the wee hours under control of cron(8). 


FILES | 
calendar 
/usr/lib/calendar to figure out today’s and tomorrow’s dates 
/etc/passwd 
/tmp/cal* 
egrep, sed, mail subprocesses 


SEE ALSO 
at(1), cron(8), mail(1) 


BUGS 
Your calendar must be public information for you to get reminder service. 
Calendar’s extended idea of ‘tomorrow’ doesn’t account for holidays. 
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NAME 
call — ring a telephone 

SYNOPSIS 
call phonenumber 

DESCRIPTION 
Cail places an outgoing call to the specified phonenumber. Nothing special happens when the 
called party answers. Phonenumber may have any number of digits; a ‘+’ sign may be used to 
specify a point at which to wait for a second dial tone. 

FILES 
/dev/dn0 


SEE ALSO 
cu(1), dn(5) 
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NAME 

cat ~ catenate and print 
SYNOPSIS 

cat{ —~u] [—-n] [—s][ —v] file... 
DESCRIPTION 


Cat reads each file in sequence and writes it on the standard output. Thus 
cat file 

prints the file, and 
cat filel file2 > file3 

concatenates the first two files and places the result on the third. 


9 


If no input file is given, or if the argument ‘—’ is encountered, cat reads from the standard 
input file. Output is buffered in 1024-byte blocks unless the standard output is a terminal, in 
which case it is line buffered. The —wu option causes the output to be completely unbuffered. 


The option —n causes the output lines to be numbered sequentially from 1. Giving —b with 
—mn causes numbers to be omitted from blank lines. 


The option —s causes the output to be single spaced by crushing out multiple adjacent empty 
lines. | 


The option —v causes non-printing characters to be printed in a visible way. Control characters 
print like “X for control-x; the delete character (octal 0177) prints as ~?. Non-ascii characters 
(with the high bit set) are printed as M- (for meta) followed by the character of the low 7 bits. 
A =e option may be given with —yvy and causes the ends of lines to be followed by the charac- 
ter ‘S$’; the —t option with —v causes tabs to be printed as ‘I. 


SEE ALSO 
cp(1), ex(1), more(1), pr(1), tail) 


BUGS 
Beware of ‘cat a b >a’ and ‘cat a b >b’, which destroy the input files before reading them. 
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NAME 

cb — C program beautifier 
SYNOPSIS 

cb 
DESCRIPTION 


Cb places a copy of the C program from the standard input on the standard output with spacing 
and indentation that displays the structure of the program. 


BUGS 
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NAME 

cc — C compiler 
SYNOPSIS 

ce [ option ] ... file 
DESCRIPTION 


Cc is the UNIX C compiler. N.B.: cc has been recently modified to accept arbitrary length 
identifiers and to produce a new object file format, see o/d(8) for information on dealing with 
old format programs. 


Ce accepts several types of arguments: 


Arguments whose names end with ‘.c’ are taken to be C source programs; they are compiled, 
and each object program is left on the file whose name is that of the source with ‘.o° substituted 
for ‘.c’. The ‘.o’ file is normally deleted, however, if a single C program is compiled and 
loaded all at one go. 

In the same way, arguments whose names end with °.s’ are taken to be assembly source pro- 
grams and are assembled, producing a ‘.o’ file. 


The following options are interpreted by cc. See /d(1) for load-time options. 


—¢ Suppress the loading phase of the compilation, and force an object file to be produced 
even if only one program is compiled. 


~ Have the compiler produce additional symbol table information for sdb(1). Also pass 
the —lg flag to id(1). 


— Suppress warning diagnostics. 


—p Arrange for the compiler to produce code which counts the number of times each rou- 
tine is called; also, if loading takes place, replace the standard startup routine by one 
which automatically calls monitor(3) at the start and arranges to write out a mon.out file 
at normal termination of execution of the object program. An execution profile can 
then be generated by use of profll). 


-O Invoke an object-code improver. 

-R Passed on to as, making initialized variables shared and read-only. 

-§ Compile the named C programs, and leave the assembier-language output on 
corresponding files suffixed ‘.s’ 

-E Run only the macro preprocessor on the named Cc programs, and send the result to the 
Standard output. 

=-C prevent the macro preprocessor from eliding comments. 

—0 output 
Name the final output file oumpus If this option is used the file ‘a.out’ will be left 
undisturbed. 

—- Dname = def 

~- Dname 


Define the name to the preprocessor, as if by ‘#define’. If no definition is given, the 
name is defined as "1". 


-U name 
Remove any initial definition of name. 


~Idir ‘#include’ files whose names do not begin with ‘/’ are always sought first in the direc- 
tory of the j/tle argument, then in directories named in —I options, then in directories 
on a standard list. 
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— B string 


Find substitute compiler passes in the files named string with the suffixes cpp, ccom 
and c2. If stringis empty, use a standard backup version. 


—t{p012] 
Find only the designated compiler passes in the files whose names are constructed by a 
~B option. In the absence of a —B option, the szringis taken to be ‘/usr/c/’. 


Other arguments are taken to be either loader option arguments, or C-compatible object pro- 
grams, typically produced by an earlier cc run, or perhaps libraries of C-compatible routines. 
These programs, together with the results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name a.out. 


FILES 
file.c input file 
file.o object file 
a.out loaded output 
/tmp/ctm? temporary 
/lib/cpp preprocessor 
/\ib/ccom compiler 


/usr/c/occom backup compiler 

/usr/c/ocpp backup preprocessor 

/lib/c2 optional optimizer 

/\ib/crtO.o runtime startoff 

/\ib/mert0.o — startoff for profiling 

Nib/libe.a standard library, see” (3) 

/usr/include standard directory for ‘#include’ files 


SEE ALSO 
B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978 
B. W. Kernighan, Programming in C—a tutorial 
D. M. Ritchie, C Reference Manual 
monitor(3), prof(1), adb(1), Id(1), sdb(1), old (8) 
DIAGNOSTICS 
The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages 
may be produced by the assembler or loader. 
BUGS 
The compiler currently ignores advice to put char, unsigned char, short or unsigned short 


variables in registers. It previously produced poor, and in some cases incorrect, code for such 
declarations. 
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NAME 
cd — change working directory 
SYNOPSIS 
ed directory 
DESCRIPTION 
Directory becomes the new working directory. The process must have execute (search) permis- 
sion in directory. 


Because a new process is created to execute each command, cd would be ineffective if it were 
written as a normal command. It is therefore recognized and executed by the shells. In csh(1) 
you may specify a list of directories in which directory is to be sought as a subdirectory if it is 
not a subdirectory of the current directory, see the description of the cdpath variable in esh(1). 


SEE ALSO 
esh(1), sh(1), pwd(1), chdir(2) 
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NAME 

checknr — check nroff/troff files 
SYNOPSIS | 

checknr —s —f [ —a.xJ.yl.x2.y2. ... .xn.yn] file ... 
DESCRIPTION 


Checknr checks a list of nroff(1) or trof(1) input files for certain kinds of errors involving 
mismatched opening and closing delimiters and unknown commands. Delimeters checked are: 


(1) Font changes using \fx ... \fP. 
(2) Size changes using \sx ... \s0. 


(3) Macros that come in open ... close forms, for example, the .TS and .TE macros which 
must always come in pairs. 


Checknr knows about the ms(7) and me(7) macro packages. 


Additional pairs of macros can be added to the list using the —a option. This must be followed 
by groups of six characters, each group defining a pair of macros. The six characters are a 
period, the first macro name, another period, and the second macro name. For example, to 
define a pair .BS and .ES, use —a.BS.ES 


The —f option requests checknr to ignore \f font changes. 
The —s option requests checknr to ignore \s size changes. 


Checknr is intended to be used on documents that are prepared with checknr in mind, much the 
same as lint. It expects a certain document writing style for \f and \s commands, in that each 
\fx must be terminated with \fP and each \sx must be terminated with \sO. While it will work 
to directly go into the next font or explicitly specify the original font or point size, and many 
existing documents actually do this, such a practice will produce complaints from checknr. Since 
it is probably better to use the \fP and 4\s0 forms anyway, you should think of this as a contri- 
bution to your document preparation style. 


SEE ALSO 
nroff(1), troff(1), ms(7), me(7), checkeqn(1) 


DIAGNOSTICS 
Complaints about unmatched delimiters. 
Complaints about unrecognized commands. | 
Various complaints about the syntax of commands. 


AUTHOR 
Mark Horton 


BUGS 
There is no way to define a 1 character macro name using —a 
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NAME 


chfn — change full name of user 


SYNOPSIS 


chfn name string 


DESCRIPTION 


Chfn is a command similar to passwd(1) except that it is used to change the gcos field of the 
password file rather than the password entry. Note that the string specified will replace the 
entire gecos field of the specified user. If (as on the UCB system) this field contains informa- 
tion in addition to the user’s full name, this information must be included in string or it will be 
deleted. Hence chfn can be used to fix phone numbers, offices, etc. 


An example use of this command would be 
chfn mark ‘& Horton,508E,7686,5240633° 


Note that the string must in general be quoted to shield blanks and special characters from the 
shell. The field should consist of the users name, followed by their office number, followed by 
the last 4 digits of their office extension and finally their home phone number. Any of these 
can be omitted. At UCB, offices can be given as ““SO8E”’ for 508 Evans, and **187MC’”’ for 
187M Cory. There should be no spaces in the entry except for those in your name. 


It is a good idea to run finger(1) on the user before and after ch/n to make sure you have for- 
matted the data correctly. 


SEE ALSO 


finger(1), passwd(5), chsh(1), passwd(1) 


AUTHOR 


BUGS 


4th Berkeley Distribution deprecated 


Mark Horton 


The encoding of the office and extension information is installation dependent. 


A new user-information data base is in the works which will supplant this program; cA/n's days 
are numbered. 
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NAME 

chmod — change mode 
SYNOPSIS 

chmod mode file ... 
DESCRIPTION 


The mode of each named file is changed according to mode, which may be absolute or symbolic. 
An absolute mode is an octal number constructed from the OR of the following modes: 


4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod(2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 
0070 read, write, execute (search) by group 
0007 read, write, execute (search) by others 


A symbolic mode has the form: 
(who] op permission {op permission] ... 


The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). 
The letter a stands for ugo. If who is omitted, the default is a but the setting of the file creation 
mask (see umask(2)) is taken into account. 


Op can be + to add permission to the file’s mode, — to take away permission and = to assign 
permission absolutely (all other bits will be reset). 


Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or 
group id) and t (save text — sticky). Letters u, g or o indicate that permission is to be taken 
from the current mode. Omitting permission is only useful with = to take away all permissions. 


The first example denies write permission to others, the second makes a file executable: 


chmod o-w file 
chmod +x file 


Multiple symbolic modes separated by commas may be given. Operations are performed in the 
order specified. The letter s is only useful with u or g. 


Only the owner of a file (or the super-user) may change its mode. 


SEE ALSO 
Is(1), chmod (2), stat(2), umask(2), chown(8) 
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NAME 
chsh — change default login shell 


SYNOPSIS 
chsh name [ shell ] 

DESCRIPTION 
Chsh is a command similar to passwd(1) except that it is used to change the login shell field of 
the password file rather than the password entry. If no shell is specified then the shell reverts to 
the default login shell /bin/sh. Otherwise only /bin/csh or /bin/oldcsh can be specified as the shell 
unless you are the super-user. 


An example use of this command would be 
chsh bill /bin/csh 


SEE ALSO 
csh(1), passwd(1), passwd(5) 
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NAME 

cifplot — CIF interpreter and plotter 
SYNOPSIS 

cifplot [ options } filel.cif { file2.cif ... ] | 
DESCRIPTION ? 


Cifplot takes a description in Cal-Tech Intermediate Form (CIF) and produces a plot. CIF is a ~ 
low-level graphics language suitable for describing integrated circuit layouts. Although CIF can 
be used for other graphics applications, for ease of discussion it will be assumed that CIF is 
used to describe integrated circuit designs. Cifplot interprets any legal CIF 2.0 description 
including symbol renaming and Delete Definition commands. In addition, a number of local 
extensions have been added to CIF, including text on plots and include files. These are dis- 


cussed later. Care has been taken to avoid any arbitrary restrictions on the CIF programs that 
can be plotted. 


To get a plot call cifplor with the name of the CIF file to be plotted. If the CIF description is 
divided among several files call cifp/or with the names of all files to be used. Cifplot reads the 
CIF description from the files in the order that they appear on the command line. Therefore 
the CIF End command should be only in the last file since cifp/or ignores everything after the 
End command. After reading the CIF description but before plotting, cifp/ot will print a esti- 
mate of the size of the plot and then ask if it should continue to produce a plot. Type y to 
proceed and n to abort. A typical run might look as follows: 


% cifplot lib.cif sorter.cif 

Window -5700 174000 -76500 168900 
Scale: 1 micron is 0.004075 inches 
The plot will be 0.610833 feet 

Do you want a plot? y 


After typing v cifp/ot will produce a plot on the Benson- Varian plotter. 


Cifplot recognizes several command line options. These can be used to change the size and 
scale of the plot, change default plot options, and to select the output device. Several options 
may be selected. A dash(-) must precede each option specifier. The following is a list of 
options that may be included on the command line: 


—w xmin xmax ymin ymax 
(window) The -w options specifies the window; by default the window is set to be large 
enough to contain the entire plot. The windowing commands lets you plot just a small 
section of your chip, enabling you to see it in better detail. Xn, xmax, ymin, and 
ymax should be specified in CIF coordinates. 


—s float 
(scale) The -s option sets the scale of the plot. By default the scale is set so that the 
window will fill the whole page. Float is a floating point number specifying the number 
of inches which represents | micron. A recommended size ts 0.02. 


| layer list | 
(layer) Normally all layers are plotted. The -! option specifies which layers NOT to 
plot. The /ayer_list consists of the layer names separated by commas, no spaces. There 
are two reserved names: text and bbox. Including the layer name text in the list 
suppresses the plotting of text, bbox suppresses the bounding box around symbols. 


—d n (depth) This option lets you limit the amount of detail plotted in a hierarchically 
designed chip. It will only instanciate the plot down a levels of calls. Sometimes too 
much detail can hide important features in a circuit. 


—g n (grid) Draw a grid over the plot with spacing every » CIF units. 
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(fuzzy) Don't print the border outlines around the merged features on each layer. 


—f 

=f (half) Plot at half normal resolution. (Not yet unplemented.) 

—@ (extensions) Accept only standard CIF. User extensions produce warnings. 

—| (non-Interactive) Do not ask for confirmation. Always plot. 

—L (List) Produce a listing of the CIF file on standard output as it is parsed. Not recom- 
mended unless debugging hand-coded CIF since CIF code can be rather long. 

—a n (approximate) Approximate a roundflash with an »-sided polygon. By default equals 
8. (I.e. roundflashes are approximated by octagons.) If 1 equals 0 then output circles 
for roundflashes. (It is best not to use full circles since rey significantly slow down 
plotting.) (Full circles not yet implemented.) 

—~b "rexf 
(banner) Print the text at the top of the plot. 

-C (Comments) Treat comments as though they were spaces. Sometimes CIF files created 
at other universities will have several errors due to syntactically incorrect comments. 
(I.e. the comments may appear in the middle of a CIF command or the comment does 
not end with a semi-colon.) Of course, CIF files should not have any errors and these 
comment related errors must be fixed before transmitting the file for fabrication. But 

fi many times fixing these errors seems to be more trouble than it is worth, especially if 
you just want to get a plot. This option is useful in getting rid of many of these com- 

! ment related syntax errors. 

—r (rotate) Rotate the plot 90 degrees. 

-V (Varian) Send output to the varian. (This is the default option.) 

—-W (Wide) Send output directiy to the versatec. 

=S (Spool) Store the output in a temporary file then dump the output quickly onto the 
Versatec. Makes nice crisp plots; also takes up a lot of disk space. 

—-T » (Terminal) Send output byte stream to standard output. Useful for setting up pipes. NV 
is the number of bytes per line that the plotting device expects. (Not yet implemented.) 

—-H (HP2648) Send output to HP2648A terminal. This requires that cifp/ot is running in 


the foreground on an HP2648 and that there is a scratch tape in the left tape drive of 
the terminal. (Not yer fully implemented.) 


—X dbasename 


(eXtractor) From the CIF file create a circuit description suitable for switch level simu- 
lation. It creates two files: basename.sim which contains the circuit description, and 
basename.node which contains the node numbers and their location used in the circuit 
description. 

When this option is invoked no plot is made. Therefore it is advisable not to use any 
of the other options that deal only with plotting. However, the window, layer, and 
approximate options are still appropriate. To get a plot of the circuit with the node 


numbers call cifp/ot again, without the —X option, and include dasename.nodes in the 


list of CIF files to be plotted. (This file must appear in the list of files before the file 
with the CIF End command.) (Not yer fully implemented.) 


—P pattern_file 


(Pattern) The -P option lets you specify your own layers and stipple patterns. 
Pattern_file may contain an arbitrary number of layer descriptors. A layer descriptor is 
the layer name in double quotes, followed by 8 integers. Each integer specifies 32 bits 
where ones are black and zeroes are white. Thus the 8 integers specify a 32 by 8 bit 
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Stipple pattern. The integers may be in decimal, octal, or hex. Hex numbers start with 
Ox’; octal numbers start with °0’. The CIF syntax requires that layer names be made 
up of only uppercase letters and digits, and not longer than four characters. The fol- 
lowing is example of a layer description for poly-silicon: 


"NP" = 0x08080808 0x04040404 0x02020202 0x01010101 
Qx80808080 0x40404040 0x20202020 0x10101010 


—F font_file 
(Font) The -F option indicates which font you want for your text. The file must be in 
the directory ’/usr/lib/vfont’. The default font is Roman 6 point. Obviously, this 
option is only useful if you have text on your plot. 


—O filename | 
(Output) After parsing the CIF files, store an equivalent but easy to parse CIF descrip- 
tion in the specified file. This option removes the include and array commands (see 
next section) and replaces them with equivalent standard CIF statements. The result- 
ing file is suitable for transmission to other facilities for fabrication. 


In the definition of CIF provisions were made for local extensions. All extension commands 
begin with a number. Part of the purpose of these extensions is to test what features would be 
suitable to include as part of the standard language. But it is important to realize that these 
extensions are not standard CIF and that many programs interpreting CIF do not recognize 
them. If you use these extensions it is advisable to create another CIF file using the -O options 
described above before submitting your circuit for fabrication. The following is a list of exten- 
sions recognized by cifplot. : 


OI fAlename; 
(Include) Read from the specified file as though it appeared in place of this command. 
Include files can be nested up to 6 deep. 


OA smndxdy; 
(Array) Repeat symbol s mm times with dx spacing in the x-direction and 7 times with dy 
spacing in the y-direction. s, m, and » are unsigned integers. dx and dy are signed 
integers in CIF units. 


1 message; 
(Print) Print out the message on standard output when it is read. 


2 “texl transform ; 


2C “text transform ; 
(Text on Plot) Text is placed on the plot at the position specified by the transformation. 
The allowed transformations are the same as the those allowed for the Call command. 
The transformation affects only the point at which the beginning of the text is to 
appear. The text is always plotted horizontally, thus the mirror and rotate transforma- 
tions are not really of much use. Normally text is placed above and to the right of the 
reference point. The 2C command centers the text about the reference point. 


9 name; 
(Name symbol) name is associated with the current symbol. 


94 name x y; 


94 name x y layer; 
(Name point) mame is associated with the point (x, y). Any mask geometry crossing 
this point is also associated with name. If layer is present then just geometry crossing 
the point on that layer is associated with name. For plotting this command ts similar to 
text on plot. When doing circuit extraction this command is used to give an explicit 
name to a node. Name must not have any spaces in it, and it should not be a number. 
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FILES 
/usr/lib/vdump 
/usr/lib/vfont/« 
/usr/lib/vpd 
/usr/tmp/cif* 
ALSO SEE 


A Guide to LS! Implementation by Hon and Sequin, Second Edition (Xerox PARC, 1980) for a 
description of CIF. 
[ntroduction to VLSI Systems by Mead and Conway (Addison-Wesley, 1980) 


AUTHOR 
Dan Fitzpatrick 


BUGS 
Output should be spooled. 


een 
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NAME 
clear — clear terminal screen 


SYNOPSIS 
clear 
DESCRIPTION 


Clear clears your screen if this is possible. It looks in the environment for the terminal type 
and then in /etc/termcap to figure out how to clear the screen. 


FILES 
/etc/termcap terminal capability data base 


BUGS 
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NAME 

cmp — compare two files 
SYNOPSIS 

emp [ —1] [ —s] filel file2 
DESCRIPTION 


The two files are compared. (If filel is ‘—’, the standard input is used.) Under default options, 
cmp makes no comment if the files are the same; if they differ, it announces the byte and line 


number at which the difference occurred. If one file is an initial subsequence of the other, that 
fact is noted. 


Options: 
—j Print the byte number (decimal) and the differing bytes (octal) for each difference. 
—g Print nothing for differing files; return codes only. 


SEE ALSO 
diff(1), comm(]) 


DIAGNOSTICS 


Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or miss- 
ing argument. , 
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NAME 


col — filter reverse line feeds 


SYNOPSIS 


col [| — bfx] 


DESCRIPTION 


Col reads the standard input and writes the standard output. It performs the line overlays 
implied by reverse line feeds (ESC-7 in ASCII) and by forward and reverse half line feeds 
(ESC-9 and ESC-8). Col is particularly useful for filtering multicolumn output made with the 
‘ rt? command of nroffand output resulting from use of the :b/(1) preprocessor. 


Although col accepts half line motions in its input, it normally does not emit them on output. 
Instead, text that would appear between lines is moved to the next lower full line boundary. 
This treatment can be suppressed by the —f (fine) option; in this case the output from co/ may 
contain forward half line feeds (ESC-9), but will still never contain either kind of reverse line 
motion. 


If the —b option is given, co/ assumes that the output device in use is not capable of backspac- 


ing. In this case, if several characters are to appear in the same place, only the last one read 
will be taken. = 


The control characters SO (ASCII code 017), and SI (016) are assumed to start and end text in 
an alternate character set. The character set (primary or alternate) associated with each printing 
character read is remembered; on output, SO and SI characters are generated where necessary 
to maintain the correct treatment of each character. 


Col normally converts white space to tabs to shorten printing time. If the —x option is given, 
this conversion is suppressed. 


All control characters are removed from the input except space, backspace, tab, return, new- 
line, ESC (033) followed by one of 7, 8, 9, SI, SO, and VT (013). This last character is an 
alternate form of full reyerse line feed, for compatibility with some other hardware conven- 
tions. All other non-printing characters are ignored. 


SEE ALSO 


BUGS 


troff(1), tbl(1), greek (1) 


Can’t back up more than 128 lines. 
No more than 800 characters, including backspaces, on a line. 
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NAME 


coicrt — filter nroff output for CRT previewing 


SYNOPSIS 


colert [— ][—2] [ file... ] 


DESCRIPTION 


Colcrt provides virtual half-line and reverse line feed sequences for terminals without such 
capability, and on which overstriking is destructive. Half-line characters and underlining 
(changed to dashing ‘—’) are placed on new lines in between the normal output lines. 


The optional — suppresses all underlining. It is especially useful for previewing allboxed tables 
from ¢d/(1). 


The option —2 causes all half-lines to be printed, effectively double spacing the output. Nor- 
mally, a minimal space output format is used which will suppress empty lines. The program 
never suppresses two consecutive empty lines, however. The —2 option is useful for sending 
output to the line printer when the output contains superscripts and subscripts which would 
otherwise be invisible. 


A typical use of colcrt would be 
tbl exum2.n | nroff —ms|colcrt — | more 


SEE ALSO 


nroff/troff(1), col(1), more(1), ul(i) 


AUTHOR 


BUGS 


William Joy 


Should fold underlines onto blanks even with the ‘—’ option so that a true underline character 
would show; if we did this, however, colcrt wouldn’t get rid of cu’d underlining completely. 


Can’t back up more than 102 lines. 
General overstriking is lost; as a special case ‘? overstruck with ‘—’ or underline becomes ‘+’. 
Lines are trimmed to 132 characters. 


Some provision should be made for processing superscripts and subscripts in documents which 
are already double-spaced. 
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NAME 
colrm — remove columns from a file 


SYNOPSIS 
colrm [ startcol [ endcol ] ] 


DESCRIPTION 


Colrm removes selected columns from a file. Input is taken from standard input. Output is 
sent to standard output. 


If called with one parameter the columns of each line will be removed starting with the 
specified column. If called with two parameters the columns from the first column to the last 
column will be removed. 


Column numbering starts with column 1. 


SEE ALSO 
expand(1) 


AUTHOR 
Jeff Schriebman 


BUGS 
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NAME 

comm — select or reject lines common to two sorted files 
SYNOPSIS 

comm [ ~ [123] } filel file2 
DESCRIPTION 


Comm treads filel and file2, which should be ordered in ASCII collating sequence, and produces 
a three column output: lines only in filel; lines only in /ffle2; and lines in both files. The 
filename ‘—’ means the standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm —12 prints only 
the lines common to the two files; comm -—23 prints only lines in the first file but not in the 
second; comm —123 is a no-op. 


SEE ALSO 
cmp(1), diff(1), uniq(1) 
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NAME 


compact, uncompact, ccat — compress and uncompress files, and cat them 


SYNOPSIS 


compact [ name ... ] 
uncompact [ name... |] 
ccat [ file ... ] 


DESCRIPTION 


Compact compresses the named files using an adaptive Huffman code. If no file names are 
given, then the standard input is compacted to the standard output. Compact operates as an 
on-line algorithm. Each time a byte is read, it is encoded immediately according to the current 
prefix code. This code is an optimal Huffman code for the set of frequencies seen so far. It is 
unnecessary to prepend a decoding tree to the compressed file since the encoder and the 
decoder start in the same state and stay synchronized. Furthermore, compact and wncompact can 
operate as filters. In particular, 


..| compact | uncompact | ... 


operates as a (very slow) no-op. 


When an argument fie is given, it is compacted and the resulting file is placed in file.C; file is 
unlinked. The first two bytes of the compacted file code the fact that the file is compacted. 
This code is used to prohibit recompaction. 


The amount of compression to be expected depends on the type of file being compressed. Typ- 
ical values of compression are: Text (38%), Pascal Source (43%), C Source (36%) and Binary 
(19%). These values are the percentages of file bytes reduced. 


Uncompact restores the original file from a file compressed by compact. If no file names are 
given, then the standard input is uncompacted to the standard output. 


Ccat cats the original file from a file compressed by compact, without uncompressing the file. 


RESTRICTION 


FILES 


The last segment of the filename must contain fewer than thirteen characters to allow space for 
the appended ’.C’. 


ban © compacted file created by compact, removed by uncompact 


SEE ALSO 


Gallager, Robert G., "Variations on a Theme of Huffman’, /.E.E.£. Transactions on Information 
Theory, vol. IT-24, no. 6, November 1978, pp. 668 - 674. 


AUTHOR 


BUGS 


Colin L. Mc Master 
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NAME 
cp — copy 
SYNOPSIS 
cp [ ~i ] filel file2 
cp [ —i ] file ... directory 


DESCRIPTION 
Filel is copied onto file2. The mode and owner of /i/e2 are preserved if it already existed; the 
mode of the source file is used otherwise. 


In the second form, one or more /i/es are copied into the directory with their original file-names. 
Cp refuses to copy a file onto itself. 


If the ~i option is specified, cp will prompt the user with the name of the file whenever the 
copy will cause an old file to be overwritten. An answer of ’y’” will cause cp to continue. Any 
other answer will prevent it from overwriting the file. 


SEE ALSO 
cat(1), pr(1), mv(Q) 
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NAME 


crypt — encode/decode 


SYNOPSIS 


crypt [ password ] 


DESCRIPTION 


FILES 


Crypt reads from the standard input and writes on the standard output. The password is a key 
that selects a particular transformation. If no password is given, crypt demands a key from the 


terminal and turns off printing while the key is being typed in. Crypt encrypts and decrypts with 
the same key: | 


crypt key <clear >cypher 
crypt key <cypher | pr 


will print the clear. 


Files encrypted by crypt are compatible with those treated by the editor ed in encryption mode. 


The security of encrypted files depends on three factors: the fundamental method must be hard 
to solve; direct search of the key space must be infeasible; ‘sneak paths’ by which keys or clear- 
text can become visible must be minimized. 


Crypt implements a one-rotor machine designed along the lines of the German Enigma, but 
with a 256-element rotor. Methods of attack on such machines are known, but not widely; 
moreover the amount of work required is likely to be large. 


The transformation of a key into the internal settings of the machine is deliberately designed to 
be expensive, i.e. to take a substantial fraction of a second to compute. However, if keys are 
restricted to (say) three lower-case letters, then encrypted files can be read by expending only a 
substantial fraction of five minutes of machine time. 


Since the key is an argument to the crypt command, it is potentially visible to users executing 
ps(1) or a derivative. To minimize this possibility, crypt takes care to destroy any record of the 
key immediately upon entry. No doubt the choice of keys and key security are the most 
vulnerable aspect of crypt. 


/dev/tty for typed key 


SEE ALSO 


BUGS 


ed(1), makekey(8) 


There is no warranty of merchantability nor any warranty of fitness for a particular purpose nor 
any other warranty, either express or implied, as to the accuracy of the enclosed materials or as 
to their suitability for any particular purpose. Accordingly, Bell Telephone Laboratories 
assumes no responsibility for their use by the recipient. Further, Bell Laboratories assumes no 
obligation to furnish any assistance of any kind whatsoever, or to furnish any additional infor- 
mation or documentation. . 
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NAME 

csh — a shell (command interpreter) with C-like syntax 
SYNOPSIS 

esh { —cefinstvVxX ] [ arg... ] 
DESCRIPTION 


Csh is a first implementation of a command language interpreter incorporating a history 
mechanism (see History Substitutions) job control facilities (see Jobs) and a C-like syntax. 
So as to be able to use its job control facilities, users of csh must (and automatically) use the 
new tty driver summarized in newrty(4) and fully described in rty(4). This new tty driver allows 
generation of interrupt characters from the keyboard to tell jobs to stop. See sty(1) for details 
On setting options in the new tty driver. 


An instance of csh begins by executing commands from the file ‘.cshre’ in the Home directory of 
the invoker. If this is a login shell then it also executes commands from the file ‘.login’ there. 
It is typical for users on crt’s to put the command ‘‘stty ert’ in their ./ogin file, and to also 
invoke tset(1) there. 


In the normal case, the shell will then begin reading commands from the terminal, prompting 
with ‘% ’. Processing of arguments and the use of the shell to process files containing com- 
mand scripts will be described later. 


The shell then repeatedly performs the following actions: a line of command input is read and 
broken into words. This sequence of words is placed on the command history list and then 
parsed. Finally each command in the current line is executed. 


When a login shell terrninates it executes commands from the file ‘.logout’ in the users home 
directory. 


Lexical structure 


The shell splits input lines into words at blanks and tabs with the following exceptions. The 
characters ‘&’ ‘{ ‘;’ ‘<’ ‘>’ ‘(? ‘)’ form separate words. If doubled in ‘&&’, 4), ‘<<’ or 
‘>>’ these pairs form single words. These parser metacharacters may be made part of other 
words, or prevented their special meaning, by preceding them with ‘\’. A newline preceded by 
a ‘\’ is equivalent to a blank. 


In addition strings enclosed in matched pairs of quotations, *’’, *” or ‘"’, form parts of a word; 
metacharacters in these strings, including blanks and tabs, do not form separate words. These 
quotations have semantics to be described subsequently. Within pairs of ‘ or °"’ characters a 
newline preceded by a ‘\’ gives a true newline character. 


When the shell’s input is not a terminal, the character ‘#’ introduces a comment which contin- 
ues to the end of the input line. It is prevented this special meaning when preceded by ‘\’ and 
in quotations using *”, ‘”, and ‘"’. 


Commands 


A simple command is a sequence of words, the first of which specifies the command to be exe- 
cuted. A simple command or a sequence of simple commands separated by ‘ characters forms 
a pipeline. The output of each command in a pipeline is connected to the input of the next. 
Sequences of pipelines may be separated by ‘;’, and are then executed sequentially. A 
sequence of pipelines may be executed without immediately waiting for it to terminate by fol- 
lowing it with an ‘&’. 

Any of the above may be placed in ‘(’ ‘)’ to form a simple command (which may be a com- 
ponent of a pipeline, etc.) It is also possible to separate pipelines with {? or ‘&&’ indicating, as 
in the C language, that the second ts to be executed only if the first fails or succeeds respec- 
tively. (See Expressions.) 
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Jobs 


The shell associates a job with each pipeline. It keeps a table of current jobs, printed by the jods 
command, and assigns them small integer numbers. When a job is started asynchronously with 
*&’, the shell prints a line which looks like: 


[1] 1234 


indicating that the jobs which was started asynchronously was job number | and had one (top- 
level) process, whose process id was 1234. 


If you are running a job and wish to do something else you may hit the key ~Z (control-Z) 
which sends a STOP signal to the current job. The shell will then normally indicate that the job 
has been ‘Stopped’, and print another prompt. You can then manipulate the state of this job, 
putting it in the background with the 5g command, or run some other commands and then 
eventually bring the job back into the foreground with the foreground command fg. A “Z takes 
effect immediately and is like an interrupt in that pending output and unread input are dis- 
carded when it is typed. There is another special key “Y which does not generate a STOP signal 
until a program attempts to read(2) it. This can usefully be typed ahead when you have 
prepared some commands for a job which you wish to stop after it has read them. 


A job being run in the background will stop if it tries to read from the terminal. Background 
jobs are normally allowed to produce output, but this can be disabled by giving the command 
‘*stty tostop’’. If you set this tty option, then background jobs will stop when they try to pro- 
duce output like they do when they try to read input. 


There are several ways to refer to jobs in the shell. The character ‘%’ introduces a job name. 
If you wish to refer to job number 1, you can name it as ‘%1’. Just naming a job brings it to 
the foreground; thus ‘%l° is a synonym for ‘fg %1’, bringing job 1 back into the foreground. 
Similarly saying ‘%1 &’ resumes job | in the background. Jobs can also be named by prefixes 
of the string typed in to start them, if these prefixes are unambiguous, thus ‘%ex’ would nor- 
mally restart a suspended ex(1) job, if there were only one suspended job whose name began 
with the string ‘ex’. it is also possible to say ‘%?string’ which specifies a job whose text con- 
tains string, if there is only one such job. a 


The shell maintains a notion of the current and previous jobs. In output pertaining to jobs, the 
current job is marked with a ‘+’ and the previous job with a ‘—’. The abbreviation ‘%+’ 
refers to the current job and ‘%—’ refers to the previous job. For close analogy with the syntax 
of the history mechanism (described below), ‘%%’ is also a synonym for the current job. 


Status reporting 


This shell learns immediately whenever a process changes state. It normally informs you when- 
ever a job becomes blocked so that no further progress is possible, but only just before it prints 
a prompt. This is done so that it does not otherwise disturb your work. If, however, you set 
the shell variable zorify, the shell will notify you immediately of changes of status in back- 
ground jobs. There is also a shell command notify which marks a single process so that its 
status changes will be immediately reported. By default norify marks the current process, simply 
say ‘notify’ after starting a background job to mark it. 


When you try to leave the shell while jobs are stopped, you will be warned that “You have 
stopped jobs.” You may use the jobs command to see what they are. If you do this or immedi- 
ately try to exit again, the shell will not warn you a second time, and the suspended jobs will be 
terminated. 
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Substitutions 


We now describe the various transformations the shell performs on the input in the order in 
which they occur. 


History substitutions 


History substitutions place words from previous command input as portions of new commands, 
making it easy to repeat commands, repeat arguments of a previous command in the current 
command, or fix spelling mistakes in the previous command with little typing and a high degree 
of confidence. History substitutions begin with the character *!’ and may begin anywhere in the 
input stream (with the proviso that they do net nest.) This ‘!’ may be preceded by an ‘\’ to 
prevent its special meaning; for convenience, a ‘!’ is passed unchanged when it is followed by a 
blank, tab, newline, ‘=’ or ‘(. (History substitutions also occur when an input line begins 
with ‘ft’. This special abbreviation will be described later.) Any imput line which contains his- 
tory substitution is echoed on the terminal before it is executed as it could have been typed 
without history substitution. 


Commands input from the terminal which consist of one or more words are saved on the his- 
tory list. The history substitutions reintroduce sequences of words from these saved commands 
into the input stream. The size of which is controlled by the Aistory variable, the previous com- 
mand is always retained, regardless of its value. Commands are numbered sequentially from 1. 


For definiteness, consider the following output from the Aistory command: 


9 write michael 
10 ex write.c 

11 cat oldwrite.c 
12 diff «write.c 


The commands are shown with their event numbers. It is not usually necessary to use event 
numbers, but the current event number can be made part of the prompt by placing an ‘!’ in the 
prompt string. 


With the current event 13 we can refer to previous events by event number ‘!]1’, relatively as 
in ‘t—2° (referring to the same event), by a prefix of a command word as in ‘!d’ for event 12 
or ‘!wri’ for event 9, or by a string contained in a word in the command as in ‘!?mic?’ also 
referring to event 9. These forms, without further modification, simply reintroduce the words 
of the specified events, each separated by a single blank. As a special case ‘!!’ refers to the pre- 
vious command; thus ‘!!’ alone is essentially a redo. 


To select words from an event we can follow the event specification by a ‘:’ and a designator for 
the desired words. The words of a input line are numbered from 0, the first (usually com- 
mand) word being 0, the second word (first argument) being 1, etc. The basic word designa- 
tors are: | 


0 first (command) word 

n n’th argument 

! first argument, i.e. ‘1’ 

3 last argument 

% word matched by (immediately preceding) ?s? search 
x—-y range of words 

—y abbreviates ‘O—y’ 


‘ abbreviates ‘f ~S’, or nothing if only 1 word in event 
xe abbreviates ‘x —$’ 
x= like ‘x’ but omitting word ‘S$’ 
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The ‘:’ separating the event specification from the word designator can be omitted if the argu- 
ment selector begins with a ‘{’, ‘$3’, ‘* ‘—’ or ‘%’. After the optional word designator can be 
placed a sequence of modifiers, each preceded by a ‘:’. The following modifiers are defined: 


h Remove a trailing pathname component, leaving the head. 
r Remove a trailing ‘.xxx’ component, leaving the root name. 
e Remove all but the extension ‘.xxx’ part. 


s/l/r/ Substitute / for r 

t Remove all leading pathname components, leaving the tail. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. ‘g&’. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 
x Like q, but break into words at blanks, tabs and newlines. 


Unless preceded by a ‘g’ the modification is applied only to the first modifiable word. With 
substitutions, it is an error for no word to be applicable. 


The left hand side of substitutions are not regular expressions in the sense of the editors, but 
rather strings. Any character may be used as the delimiter in place of ‘/’; a ‘\’ quotes the del- 
imiter into the / and r strings. The character ‘&’ in the right hand side is replaced by the text 
from the left. A ‘\’ quotes ‘&’ also. A null / uses the previous string either from a /or from a 
contextual scan string sin *!?s?’. The trailing delimiter in the substitution may be omitted if a 
newline follows immediately as may the trailing ‘?” in a contextual scan. 


A history reference may be given without an event specification, e.g. ‘!S’. In this case the 
reference is to the previous command unless a previous history reference occurred on the same 
line in which case this form repeats the previous reference. Thus ‘!?foo?f{ !S° gives the first 
and last arguments from the command matching ‘?foo?’. | 


A special abbreviation of a history reference occurs when the first non-blank character of an 
input line is a ‘f°. This is equivalent to ‘!:s{’ providing a convenient shorthand for substitu- 
tions on the text of the previous line. Thus ‘flbflib’ fixes the spelling of ‘lib’ in the previous 
command. Finally, a history substitution may be surrounded with ‘{’ and ‘}’ if necessary to 
insulate it from the characters which follow. Thus, after ‘Is —Id “paul’ we might do ‘!{I}a’ to 
do ‘Is —Id “paula’, while ‘!la’ would look for a command starting ‘la’. 


Quotations with © and” 


The quotation of strings by ‘“’ and ‘"’ can be used to prevent all or some of the remaining sub- 
stitutions. Strings enclosed in “’ are prevented any further interpretation. Strings enclosed in 
‘"’ are yet variable and command expanded as described below. 


In both cases the resulting text becomes (all or part of) a single word; only in one special case 
(see Command Substitition below) does a ‘”’ quoted string yield parts of more than one word, ‘” 
quoted strings never do. 


Alias substitution 


The shell maintains a list of aliases which can be established, displayed and modified by the 
alias and unalias commands. After a command line is scanned, it is parsed into distinct com- 
mands and the first word of each command, left-to-right, is checked to see if it has an alias. If 
it does, then the text which is the alias for that command is reread with the history mechanism 

available as though that command were the previous input line. The resulting words replace 
the command and argument list. If no reference is made to the history list, then the argument 
list is left unchanged. 7 
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Thus if the alias for ‘Is’ is ‘ls —I’ the command ‘ls /usr’ would map to ‘Is —! /usr’, the argu- 
ment list here being undisturbed. Similarly if the alias for ‘lookup’ was ‘grep !{ /etc/passwd’ 
then ‘lookup bill’ would map to ‘grep bill /etc/passwd’. 


If an alias is found, the word transformation of the input text is performed and the aliasing pro- 
cess begins again on the reformed input line. Looping is prevented if the first word of the new 
text is the same as the old by flagging it to prevent further aliasing. Other loops are detected 
and cause an error. 


Note that the mechanism allows aliases to introduce parser metasyntax. Thus we can ‘alias 
print ‘pr \!* | lpr’? to make a command which pr’s its arguments to the line printer. 


Variable substitution 


The shell maintains a set of variables, each of which has as value a list of zero or more words. 
Some of these variables are set by the shell or referred to by it. For instance, the argv variable 
is an image of the shell’s argument list, and words of this variable’s value are referred to in 
special ways. | 


The values of variables may be displayed and changed by using the set and unset commands. Of 
the variables referred to by the shell a number are toggles; the shell does not care what their 
value is, only whether they are set or not. For instance, the verbose variable is a toggle which 
causes command input to be echoed. The setting of this variable results from the —v com- 
mand line option. 


Other operations treat variables numerically. The ‘@’ command permits numeric calculations 
to be performed and the result assigned to a variable. Variable values are, however, always 
represented as (zero or more) strings. For the purposes of numeric operations, the null string 
is considered to be zero, and the second and subsequent words of multiword values are ignored. 


After the input line is aliased and parsed, and before each command is executed, variable sub- 
stitution is performed keyed by ‘S’ characters. This expansion can be prevented by preceding 
the ‘S’ with a ‘\’ except within ‘"’s where it always occurs, and within ‘’’s where it never 
occurs. Strings quoted by ‘” are interpreted later (see Command substitution below) so ‘$’ sub- 
stitution does not occur there until later, if at ali. A ‘S$’ is passed unchanged if followed by a 
blank, tab, or end-of-line. 


Input/output redirections are recognized before variable expansion, and are variable expanded 
separately. Otherwise, the command name and entire argument list are expanded together. It 
is thus possible for the first (command) word to this point to generate more than one word, the 
first of which becomes the command name, and the rest of which become arguments. 


Unless enclosed in “"’ or given the °:q’ modifier the results of variable substitution may eventu- 
ally be command and filename substituted. Within ‘*’ a variable whose value consists of multi- 
ple words expands to a (portion of) a single word, with the words of the variables value 
separated by blanks. When the ‘:q’ modifier is applied to a substitution the variable will expand 
to multiple words with each word separated by a blank and quoted to prevent later command or 
filename substitution. 


The following metasequences are provided for introducing variable values into the sheil input. 
Except as noted, it is an error to reference a variable which is not set. 


$name 

${name} 
Are replaced by the words of the value of variable name, each separated by a blank. 
Braces insulate name from following characters which would otherwise be part of it. Shell 
variables have names consisting of up to 20 letters and digits starting with a letter. The 
underscore character is considered a letter. 
If name is not a shell variable, but is set in the environment, then that value is returned 
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(but : modifiers and the other forms given below are not available in this case). 

$name [selector] 

${name[selector]} 
May be used to select only some of the words from the value of mame. The selector is 
subjected to ‘3’ substitution and may consist of a single number or two numbers separated 
by a ‘—’. The first word of a variables value is numbered ‘1’. If the first number of a 
range is omitted it defaults to ‘1’. If the last member of a range is omitted it defaults to 
‘$#name’. The selector ‘*’ selects all words. It is not an error for a range to be empty if 
the second argument is omitted or in range. 

$#name 

${#name} 

Gives the number of words in the variable. This is useful for later use in a ‘{selector]’. 

$0 eet | | 

Substitutes the name of the file from which command input is being read. An error 

occurs if the name is not known. 


$number 
${number} 
Equivalent to ‘Sargv{number]’. 
$+ | 
Equivalent to ‘Sargv[+]}’. 
The modifiers ‘:h’, ‘:t’, ‘ir’, ‘:q’ and ‘:x’ may be applied to the substitutions above as may ‘:gh’, 


‘gt’ and ‘:gr’. If braces ‘{’ ’}’ appear in the command form then the modifiers must appear 
within the braces. The current implementation allows only one ‘:’ modifier on each ‘S$’ 


expansion. 
The following substitutions may not be modified with ‘:’ modifiers. 
$?name 
${?name} 
Substitutes the string ‘1’ if name is set, ‘0’ if it is not. 
$70 | | 
Substitutes ‘1’ if the current input filename is know, ‘0’ if it is not. 
$$ 
Substitute the (decimal) process number of the (parent) shell. 
$< 


Substitutes a line from the standard input, with no further interpretation thereafter. It 
can be used to read from the keyboard in a shell script. 


Command and filename substitution 


The remaining substitutions, command and filename substitution, are applied selectively to the 
arguments of builtin commands. This means that portions of expressions which are not 
evaluated are not subjected to these expansions. For commands which are not internal to the 
shell, the command name is substituted separately from the argument list. This occurs very 
late, after input-output redirection is performed, and in a child of the main shell. 


Command substitution 


Command substitution is indicated by a command enclosed in ‘’. The output from such a 
command is normally broken into separate words at blanks, tabs and newlines, with null words 
being discarded, this text then replacing the original string. Within ‘"’s, only newlines force 
new words; blanks and tabs are preserved. 
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In any case, the single final newline does not force a new word. Note that it is thus possible for 
a command substitution to yiela only part of a word, even if the command outputs a complete 
line. | 


Filename substitution 


If a word contains any of the characters ‘*’, ‘9’, ‘{’ or ‘{’ or begins with the character ‘~’, then 
that word is a candidate for filename substitution, also known as ‘globbing’. This word is then 
regarded as a pattern, and replaced with an alphabetically sorted list of file names which match 
the pattern. In a list of words specifying filename substitution it is an error for no pattern to 
match an existing file name, but it is not required for each pattern to match. Only the meta- 
characters ‘*’, ‘?’ and ‘[’ imply pattern matching, the characters ‘~’ and ‘{’ being more akin to 
abbreviations. | 

In matching filenames, the character ‘.’ at the beginning of a filename or immediately following 
a ‘/°, as weil as the character ‘/’ must be matched explicitly. The character ‘*’ matches any 
string of characters, including the null string. The character ‘?’ matches any single character. 
The sequence ‘{...]’ matches any one of the characters enclosed. Within ‘{...]’, a pair of charac- 
ters separated by ‘—° matches any character lexically between the two. 


4G 


at the beginning of a filename is used to refer to home directories. Standing 
alone, i.e. °~” it expands to the invokers home directory as reflected in the value of the variable 
home. When followed by a name consisting of letters, digits and ‘—’ characters the shell 
searches for a user with that name and substitutes their home directory; thus ‘“ken’ might 
expand to ‘/usr/ken’ and ‘“ken/chmach’ to ‘/usr/ken/chmach’. If the character ‘~* is followed. 
by a character other than a letter or ‘/’ or appears not at the beginning of a word, it is left 
undisturbed. 


The metanotation ‘a{b,c,dje’ is a shorthand for ‘abe ace ade’. Left to right order is preserved, 
with results of matches being sorted separately at a low level to preserve this order. This con- 
struct may be nested. Thus ‘“source/sl/{oldis,ls}.c’ expands to ‘/usr/source/s1/oldls.c 
/usr/source/si/Is.c’ whether or not these files exist without any chance of error if the home 
directory for ‘source’ is ‘/usr/source’. Similarly *./{memo,*box}’ might expand to ‘../memo 
../box ../mbox’. (Note that ‘memo’ was not sorted with the results of matching ‘*box’.) As a 

special case ‘{’, *}’ and ‘{}’ are passed undisturbed. 


The character 


input/output 


The standard input and standard output of a command may be redirected with the following 
syntax: 


< name 
Open file name (which is first variable, command and filename expanded) as the standard 
input. | | 


<< word | 
Read the shell input up to a line which is identical to word. Word is not subjected to vari- 
able, filename or command substitution, and each input line is compared to word before 
any substitutions are done on this input line. Unless a quoting ‘\’, ‘"’, “°° or ‘” appears in 
word variable and command substitution is performed on the intervening lines, allowing 
‘\" to quote ‘$’, ‘\’ and “°°. Commands which are substituted have all blanks, tabs, and 
newlines preserved, except for the final newline which is dropped. The resultant text is 
placed in an anonymous temporary file which is given to the command as standard input. 

> name 

>! name 

> & name 
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"The file name is used as standard output. If the file does not exist then it is created: if the 
file exists, its is truncated, its previous contents being lost. 


If the variable noclobber is set, then the file must not exist or be a character special file 
(e.g. a terminal or ‘/dev/null’) or an error results. This helps prevent accidental destruc- 
tion of files. In this case the ‘!’ forms can be used and suppress this check. 


The forms involving ‘&’ route the diagnostic output into the specified file as well as the 
standard output. Name is expanded in the same way as ‘<’ input filenames are. 

> =» mame 

>>& name 

>>! name 

>>&! name 
Uses file name as standard output like ‘>’ but places output at the end of the file. If the 
variable noclobber is set, then it is ai: error for the file not to exist unless one of the ‘! 
forms is given. Otherwise similar to ‘>’. 


A command receives the environment in which the shell was invoked as modified by the 
input-output parameters and the presence of the command in a pipeline. Thus, unlike some 
previous shells, commands run from a file of shell commands have no access to the text of the 
commands by default; rather they receive the original standard input of the shell. The ‘<<’ 
mechanism should be used to present inline data. This permits shell command scripts to func- 
tion as components of pipelines and allows the shell to block read its input. Note that the 
default standard input for a command run detached is net modified to be the empty file 
‘/dev/null’; rather the standard input rernains as the original standard input of the shell. If this 
is a terminal and if the process atternpts to read from the terminal, then the process will block 
and the user will be notified (see Jobs above.) 


Diagnostic output may be directed through a pipe with the standard output. Simply use the 
form ‘|&’ rather than just ‘. 


Expressions 


A number of the builtin commands (to be described subsequently) take expressions, in which 
the operators are similar to those of C, with the same precedence. These expressions appear in 
the @, exit, if and while commands. The following operators are available: 


|] &&e | ft & mw tee me I ce >See << > <K Sm +t — 2 S/H!” () 


Here the precedence increases to the right, ‘===’ ‘!="’ °=”’ and ‘!7’, ‘<=’ ‘> mm’ ‘<° and 
‘>’ $< <’ and ‘>>’, ‘+’ and ‘—’, ‘=’ ‘/ and ‘%’ being, in groups, at the same level. The 
eo “fame” Soe” and ‘17? operators compare their arguments as strings, all others operate on 
numbers. The operators ‘= and ‘!" are like “l=«' a ‘=e=’ except thal the rignt hand side is 
a pattern (containing, e.g. ‘#’s, °?’s and instances of ‘[...]’) against which the left hand operand 


This r eaucrs the need for use of the switch statement in shell scripts when all that 


Strings which begin with ‘QO’ are considered octal numbers. Null or missing arguments are con- 
sidered ‘0°. The result of all expressions are strings, which represent decimal numbers. It ts 
important to note that no two components of an expression can appear in the same word, 
except when adjacent to components of expressions which are syntactically significant to the 
parser (‘&’ ‘? '<’ ‘>’ ‘(? ‘)’) they should be surrounded by spaces. 


Also available in expressions as primitive operands are command executions enclosed in ‘{’ and 
‘Y and file enquiries of the form ‘~/ name’ where /is one of: 
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r read access 

wW write access 

x execute access 
€ existence 

QO ownership 

Zz zero size 

f plain file 

d directory 


The specified name is command and filename expanded and then tested to see if it has the 
specified relationship to the real user. If the file does not exist or is inaccessible then al! 
enquines retum false, i.e. ‘0’. Command executions succeed, returning true, i.e. ‘1’, if the 
command exits with status 0, otherwise they fail, returning false, i.e. ‘0’. If more detailed 
Status infoimation is required then the command should be executed outside of an expression 
and the variable siaius examined. 


Control flow 


The shell contains ; nber of commands which can be used to regulate the flow of control in 
command files (shell a and (in limited but useful ways) from terminal input. These com- 
mands ail operate by forcing the shell to reread or skip in its input and, due to the implementa- 


tion, restrict the ex cern some of the commands. 


The foreach, switch, and while Stal ments, as well as the if—then—else form of the if statement 
require that the major keyword Pca in a single simple command on an input line as shown 
below 


iell’s input is not seekable, the shell buffers up input whenever a ney . end read and 
performs seeks in this internai buffer to accomplish the rereading implied by the loo; Tot 


extent that this allows, backward goto's will succeed on non-seekable inputs.) 


mmands 
imands are executed within the shell. If a builtin command occurs as any com- 
a pipeline except the iast then it is executed in a subshell. 

sine 

alias name 

alias name wordlist 


The first form prints ail aliases. The second form prints the alias for name. The final 
form assigns the specified wordlist as the alias of name; wordlist is command and filename 
substituted. Name is not allowed to be alias or unalias. 


alloc 
Shows the amount of dynamic core in use, broken down into used and free core, and 
address of the last location in the heap. With an argument shows each used and free 
block on the internal dynamic memory chain indicating its address, size, and whether it Is 
used or free. This is a debugging command and may not work in production versions of 
the shell; it requires a modified version of the system memory allocator. 

bg 

bg %job .. 
Puts the current or specified jobs into the background, continuing them if they were 
stopped. 

break 
Causes execution to resume after the end of the nearest enclosing foreach or while. The 
remaining commands on the current line are executed. Multi-level breaks are thus possi- 
ble by writing them all on one line. 
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breaksw 
Causes a break from a switch, resuming after the endsw. 


ease label: 
A label in a switch statement as discussed below. 

ed 

cd name 

ehdir 

chdir name 
Change the shells working directory to directory name. If no argument is given then 
change to the home directory of the user. 
If name is not found as a subdirectory of the current directory (and does not begin with 
‘?, ‘7 or ‘../°7), then each component of the variable cdpath is checked to see if it has a 
subdirectory mame. Finally, if all else fails but mame is a shell variable whose value begins 
with ‘/’, then this ts tried to see if it is a directory. 

continue | 
Continue execution of the nearest enclosing while or foreach. The rest of the commands 
on the current line are executed. 

default: 
Labels the default case in a switch statement. The default should come after all case 
labels. 

dirs 
Prints the directory stack; the top of the stack is at the left, the first directory in the stack 
being the current directory. 

echo wordlist 

echo —n wordlist 
The specified words are written to the shells standard output, separated by spaces, and ter- 
minated with a newline unless the ~n option is specified. 

else 

end 

endif 

endsw 
See the description of the foreach, if switch, and waile statements below. 


eval arg .. 
(As in sh(1).) The arguments are read as poor to the shell and the resulting command (s) 
executed. This is u aes used to execute commands generated as the result of command 
or variable substitution, since parsing occurs bel re these substitutions. See sser(1) for an 


exampie of using a 


exec command 
The specified command is executed in place of the current shell. 


he 
xit (expr) 
The shell exits either with the value of the seatus variable (first form) or with the value of 
the specified expr (second form). 
fg 
fg “job ... | 
Brings the current or specified jobs into the foreground, continuing them if they were 
stopped. 
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foreach name (wordlist) 


end 
The variable name is successively set to each member of wordlist and the sequence of 
commands between this command and the matching end are executed. (Both foreach and 
end must appear alone on separate lines.) 


The builtin command continue may be used to continue the loop prematurely and the buil- 
tin command éreak to terminate it prematurely. When this command is read from the 
terminal, the loop is read up once prompting with ‘?’ before any statements in the loop 
are executed. If you make a mistake typing in a loop at the terminal you can rub it out. 


glob wordlist 
Like echo but no ‘\’ escapes are recognized and words are delimited by null characters in 
the output. Useful for programs which wish to use the shell to filename expand a list of 
words. 


goto word 
The specified word is filename and command expanded to yield a es of the form 
‘label’. The shell rewinds its input as much as possible and searches for a line of the form 
‘label:’ passibly preceded by blanks or tabs. Execution continues after the specified line. 


hashstat 
Print a statistics line indicating how effective the internal hash table has been at locating 
commands (and avoiding exec’s). An exec is attempted for each component of the pazh 
where the hash function indicates a possible hit, and in each component which does not 
begin with a ‘/’. 

history 

history 7 

history ~ra 
Displays the history event list; if 7 is given only the nm most recent events are printed. 
The —r option reverses the order of printout to be most recent first rather than oldest 
first. 


if (expr) command 
If the specified expression evaluates true, then the single command with arguments is exe- 
cuted. Variable substitution on command happens early, at the same time it does for the 
rest of the if command. Command must be a simple command, not a pipeline, a com- 
se list, or a parenthesized command list. Input/output redirection occurs even if expr 
is false, when command is not executed (this is a bug). 


if (expr) then 
else if (expr2) then 
else 


endif 
If the specified expr is true then the commands to the first else are executed; else if expr2 
is true then the commands to the second else are executed, etc. Any number of else-if 
pairs are possible: only one endifis needed. The else part is likewise optional. (The words 
else and endif must appear at the beginning of input lines; the must appear alone on its 
input line or after an eise.) 
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jobs —! 
Lists the active jobs; given the ~1 options lists process id’s in addition to the normal 
information. 


kill %job 

kill —sig %job ... 

kill pid 

kill ~sig pid ... 

kill —] 
Sends either the TERM (terminate) signal or the specified signal to the specified jobs or 
processes. Signals are either given by number or by names (as given in 
lusrlinciude/signal.h, stripped of the prefix ‘““SIG’’). The signal names are listed by ‘‘kill 
—|’. There is no default, saying just ‘kill? does not send a signal to the current job. If 
the signal being sent is TERM (terminate) or HUP (hangup), then the job or process will 
be sent a CONT (continue) signal as well. 

limit 

limit resource 

limit resource maximum-use 
Limits the consumption by the current process and each process it creates to not individu- 
ally exceed maximum-use on the specified resource. If no maximum-use is given, then the 
current limit is printed; if no resource is given, then all limitations are given. 


Resources controllable currently include cputime (the maximum number of cpu-seconds to 
be used by each process), filesize (the largest single file which can be created), datasize 
(the maximum growth of the data+stack region via sbrk(2) beyond the end of the pro- 
gram text), stacksize (the maximum size of the automatically-extended stack region), and 
coredumpsize (the size of the largest core dump that will be created). 


The maximum-use may be given as a (floating point or integer) number followed by a 
scale factor. For all limits other than cputime the default scale is ‘k’ or ‘kilobytes’ (1024 
bytes); a scale factor of ‘m’ or ‘megabytes’ may also be used. For cputime the default 
scaling is ‘seconds’, while ‘m’ for minutes or ‘h’ for hours, or a time of the form ‘mm:ss’ 
giving minutes and seconds may be used. 


For both resource names and scale factors, unambiguous prefixes of the names suffice. 
login 
Terminate a login shell, replacing it with an instance of /bin/login. This is one way to log 
off, included for compatibility with s#(1). 
logout 
Terminate a login shell. Especially useful if ignoreeofis set. 


newerp 
Changes the group identification of the caller; for details see newgrp(1). A new shell ts 
executed by newerp so that the shell state ts lost. 

nice 

nice +number 

nice command 

nice -number command 
The first form sets the nice for this shell to 4. The second form sets the nice to the given 
number. The final two forms run command at priority 4 and number respectively. The 
super-user may specify negative niceness by using ‘nice —number ..... Command is 
always executed in a sub-shell, and the restrictions place on commands in simple //state- 
ments apply. 
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nohup 

nohup command 
The first form can be used in shell scripts to cause hangups to be ignored for the 
remainder of the script. The second form causes the specified command to be run with 
hangups ignored. All processes detached with ‘&’ are effectively noAup’ed. 


notify 

notify %job ... 
Causes the shell to notify the user asynchronously when the status of the current or 
specified jobs changes; normally notification is presented before a prompt. This is 
automatic if the shell variable rosify is set. 


onintr 

onintr -- 

onintr label 
Control the action of the shell on interrupts. The first form restores the default action of 
the shell on interrupts which is to terminate shell scripts or to return to the terminal com- 
mand input level. The second form ‘onintr —’ causes all interrupts to be ignored. The 
final form causes the shell to execute a ‘goto label’ when an interrupt is received or a 
child process terminates because it was interrupted. 


In any case, if the shell is running detached and interrupts are being ignored, all forms of 
onintr have no meaning and interrupts continue to be ignored by the sheil and all invoked 
commands. 


popd 

popd +n 
Pops the directory stack, returning to the new top directory. With a argument ‘+7 dis- 
cards the th entry in the stack. The elements of the directory stack are numbered from 
Q starting at the top. 


pushd 

pushd name 

pushd +n 
With no arguments, pushd exchanges the top two elements of the directory stack. Given a 
name argument, pushd changes to the new directory (ala cd) and pushes the old current 
working directory (as in csw/ onto the directory stack. With a numeric argument, rotates 
the mth argument of the directory stack around to be the top element and changes to it. 
The members of the directory stack are numbered from the top starting at 0. 


rehash 
Causes the internal hash table of the contents of the directories in the path variable to be 
recomputed. This is needed if new commands are added to directories in the path while 
you are logged in. This should only be necessary if you add commands to one of your 
own directories, or if a systems programmer changes the contents of one of the system 
directories. 


repeat count command 
The specified command which is subject to the same restrictions as the command in the 
one line /f/statement above, is executed count times. I/O redirections occur exactly once, 
even if count is 0. 

set 

set name 


set name = word 
set name [index] = word 


# 
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set name = (wordlist) | 
_ The first form of the command shows the value of all shell variables. Variables which 
have other than a single word as value print as a parenthesized word list. The second 
form sets name to the null string. The third form sets name to the single word. The 
fourth form sets the index’th component of name to word; this component must already 
exist. The final form sets name to the list of words in wordlist. In all cases the value is 
command and filename expanded. 


These arguments may be repeated to set multiple values in a single set command. Note 
however, that variable expansion happens for all arguments before any setting occurs. 


seteny name value 
Sets the value of environment variable name to be value, a single string. The most com- 
monly used environment variable USER, TERM, and PATH are automatically imported 
to and exported from the csA variables user, term, and path; there is no need to use setenv 
for these. | 


shift 

shift variable 
The members of argv are shifted to the left, discarding argv{//. It is an error for argv not 
to be set or to have less than one word as value. The second form performs the same 
function on the specified variable. 


source name 
The shell reads commands from name. Source commands may be nested; if they are 
nested too deeply the shell may run out of file descriptors. An error in a source at any 
level terminates all nested source commands. Input during source commands is never 
placed on the history list. 


stop 
stop %job ... 
Stops the current or specified job which is executing in the background. 


suspend 
Causes the shell to stop in its tracks, much as if it had been sent a stop signal with “Z. 
This is most often used to stop shells started by su(1). 


switch (string) 
case strl: 


breaksw 
default: 


breaksw 

endsw 
Each case label is successively matched, against the specified srring which is first command 
and filename expanded. The file metacharacters ‘»*’, ‘?’ and ‘[...]" may be used in the case 
labels, which are variable expanded. If none of the labels match before a ‘default’ label ts 
found, then the execution begins after the default label. Each case label and the default 
label must appear at the beginning of a line. The command breaksw causes execution to 
continue after the endsw. Otherwise control may fall through case labels and default labels 
as in C. If no label matches and there is no default, execution continues after the endsw. 

time 

time command 
With no argument, a summary of time used by this shell and its children is printed. If 
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arguments are given the specified simple command is timed and a time summary as 
described under the time variable is printed. If necessary, an extra shell is created to print 
the time statistic when the command completes. 


umask 

umask value 
The file creation mask is displayed (first form) or set to the specified value (second form). 
The mask is given in octal. Common values for the mask are 002 giving all access to the 
group and read and execute access to others or 022 giving all access except no write access 
for users in the group or others. 


unalias pattern 
All aliases whose names match the specified pattern are discarded. Thus ali aliases are 
removed by ‘unalias *’. It is not an error for nothing to be unaliased. 


unhash 
Use of the internal hash table to speed location of executed programs is disabled. 


unlimit resource 

unlimit 
Removes the limitation on resource. If no resource is specified, then all resource limita- 
tions are removed. 


unset pattern 
All variables whose names match the specified pattern are removed. Thus ail variables 
are removed by ‘unset «’; this has noticeably distasteful side-effects. It is not an error for 
nothing to be unset. 


unseteny pattern 
Removes all variables whose name maich the specified pattern from the environment. 
See also the setenv command above and printenv(1). 

wait 
All background jobs are waited for. It the shell is interactive, then an interrupt can dis- 
rupt the wait, at which time the shell prints names and job numbers of all jobs known to 
be outstanding. 


while (expr) 


end 


While the specified expression evaluates non-zero, the commands between the while and 
the matching end are evaluated. Break and continue may be used to terminate or continue 
the loop prematurely. (The waéile and end must appear alone on their input lines.) 
Prompting occurs here the first time through the loop as for the foreach statement if the 
input is a terminal. 

% job 
Brings the specified job into the foreground. 

%iob & 
Continues the specified jod in the background. 

@ 


@ name = expr 

@ name(index] = expr 
The first forrn prints the values of all the shell variables. The second form sets the 
specified name to the value of expr. If the expression contains ‘<’, ‘>’, ‘&’ or { then at 
least this part of the expression must be placed within ‘( ‘)’. The third form assigns the 
value of expr to the index'th argument of name. Both name and its index’th component 
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must already exist. 


The operators ‘*™’, ‘+ =”, etc are available as in C. The space separating the name from 
the assignment operator is optional. Spaces are, however, mandatory in separating com- 
ponents of expr which would otherwise be single words. 


Special postfix ‘++° and ‘~—’ operators increment and decrement mame respectively, 
i.e. °@ i++’. 


Pre-defined and environment variables 


The following variables have special meaning to the shell. Of these, argv, cwd, home, path, 
prompt, shelland status are always set by the shell. Except for cwdand srarus this setting occurs 


only at initialization; these variables will not then be modified unless this is done explicitly by 
the user. | 


This shell copies the environment variable USER into the variable user, TERM into term, and 
HOME into home, and copies these back into the environment whenever the normal shell vari- 
ables are reset. The environment variable PATH is likewise handled; it is not necessary to 
worry about its setting other than in the file .cskre as inferior csh processes will import the 
definition of pathfrom the environment, and re-export it if you then change it. (It could be set 
once in the ./oginexcept that commands through ner(1) would not see the definition. ) 


argy Set to the arguments to the shell, it is from this variable that positional param- 
eters are substituted, i.e. ‘$1’ is replaced by ‘Sargv(1]’, etc. 

cdpath Gives a list of alternate directories searched to find subdirectories in chdircom- 
mands. 

ewd The full pathname of the current directory. 

echo Set when the —x command line option is given. Causes each command and 


its arguments to be echoed just before it is executed. For non-builtin com- 
mands all expansions occur before echoing. Builtin commands are echoed 
before command and filename substitution, since these substitutions are then 
done selectively. 


histchars Can be given a string value to change the characters used in history substitu- 
tion. The first character of its value is used as the history substitution charac- 
ter, replacing the default character !. The second character of its value replaces 
the character | in quick substitutions. 


history Can be given a numeric value to control the size of the history list. Any com- 
mand which has been referenced in this many events will not be discarded. 
Too large values of history may run the shell out of memory. The last exe- 
cuted command is always saved on the history list. 


home The home directory of the invoker, initialized from the environment. The 
filename expansion of ‘~’ refers to this variable. 


ignoreeof If set the shell ignores end-of-file from input devices which are terminals. 
This prevents shells from accidentally being killed by control-D’s. 
mail The files where the shell checks for mail. This is done after each command 


completion which will result in a prompt, if a specified interval has elapsed. 
The shell says ‘You- have new mail.’ if the file exists with an access time not 
greater than its modify time. 


If the first word of the value of mail is numeric it specifies a different mail 
checking interval, in seconds, than the default, which is 10 minutes. 


If multiple mail files are specified, then the shell says ‘New mail in name’ 
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when there is mail in the file name. 


As described in the section on /nput/ourput, restrictions are placed on output 
redirection to insure that files are not accidentally destroyed, and that ‘>>’ 
redirections refer to existing files. 


If set, filename expansion is inhibited. This is most useful in shell scripts 
which are not dealing with filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 


If set, it is not an error for a filename expansion to not match any existing 
files, rather the primitive pattern is returned. It is still an error for the primi- 
tive pattern to be malformed, i.e. ‘echo [° still gives an error. 


If set, the shell notifies asynchronously of job completions. The default is ww 
rather present job compietions just before printing a prompt. 


Each word of the path variable specifies a directory in which commands are to 
be sought for execution. A null word specifies the current directory. If there 
is no path variable then only full path names will execute. The usual search 
path is °.’, ‘/bin’ and ‘/usr/bin’, but this may vary from system to system. For 
the super-user the default search path is ‘/etc’, ‘/bin’ and ‘/usr/bin’. A shell 
which is given neither the -ec nor the —t option will normally hash the con- 
tents of the directories in the path variable after reading .cshrc, and each time 
the path variable is reset. If new commands are added to these directories 
while the shell is active, it may be necessary to give the rehash or the com- 
mands may not be found. 


The string which is printed before each command is read from an interactive 
terminal input. If a ‘!’ appears in the string it will be replaced by the current 
event number unless a preceding ‘\’ is given. Default is ‘% °, or ‘#° for the 
super-user. 


The file in which the shell resides. This is used in forking shells to interpret 
files which have execute bits set, but which are not executable by the system. 
(See the description of Non-builtin Command Execution below.) Initialized to 
the (system-dependent) home of the shell. 


The status returned by the last command. If it terminated abnormally, then 
0200 is added to the status. Builtin commands which fail return exit status ‘1’, 
all other builtin commands set status ‘0’. 


Controls automatic timing of commands. If set, then any command which 
takes more than this many cpu seconds will cause a line giving user, system, 
and real times and a utilization percentage which is the ratio of user plus sys- 
tern times to real time to be printed when it terminates. 


Set by the ~v command line option, causes the words of each command to be 
printed after history substitution. 


Non-builtin command execution 


When a command to be executed is found to not be a builtin command the shell attempts to 
execute the command via exec(2). Each word in the variable path names a directory from 
which the shell will attempt to execute the command. If it is given neither a —c nora —t 
option, the shell will hash the names in these directories into an internal table so that it will 
only try an exec in a directory if there is a possibility that the command resides there. This 
- greatly speeds command location when a large number of directories are present in the search 
path. If this mechanism has been turned off (via unhash), or if the shell was given a —cor —t 
argument, and in any case for each directory component of path which does not begin with a 
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‘/’, the shell concatenates with the given command name to form a path name of a file which it 
then attempts to execute. . 


Parenthesized commands are always executed in a subshell. Thus ‘(cd ; pwd) ; pwd’ prints the 
home directory; leaving you where you were (printing this after the home directory), while ‘cd ; 


pwd’ leaves you in the home directory. Parenthesized commands are most often used to 
prevent chdir from affecting the current shell. 


If the file has execute permissions but is not an executable binary to the system, then it is 
assumed to be a file containing shell commands an a new shell is spawned to read it. 


If there is an a@liasfor shellthen the words of the alias will be prepended to the argument list to 
form the shell command. The first word of the alias should be the full path name of the shell 
(e.g. ‘$shell’). Note that this is a special, late occurring, case of alias substitution, and only 
allows words to be prepended to the argument list without modification. 


Argument list processing 


If argument 0 to the shell is ‘—’ then this is a login shell. The flag arguments are interpreted 
as follows: 


-c Commands are read from the (single) following argument which must be present. Any 
“remaining arguments are placed in argv. 


—~e The shell exits if any invoked command terminates abnormally or yields a non-zero exit 
status. 


-~f The shell will start faster, because it will neither search for nor execute commands from 
the file ‘.cshrc’ in the invokers home directory. 


-i The shell is interactive and prompts for its top-level input, even if it appears to not be a 


terminal. Shells are interactive without this option if their inputs and outputs are termi- 
nals. 


~n Commands are parsed, but not executed. This may aid in syntactic checking of shell 
scripts. 


-—s Command input is taken from the standard input. 


~t¢ A single line of input is read and executed. A ‘\’ may be used to escape the newline at 
the end of this line and continue onto another line. 


—y Causes the verbose variable to be set, with the effect that command input is echoed after 
history substitution. 


— x Causes the echo variable to be set, so that commands are echoed immediately before exe- 
cution. 


—Y Causes the verbose variable to be set even before ‘.cshrc’ is executed. 
~X Isto ~xas ~Visto ~v. 


After processing of flag arguments if arguments remain but none of the —c, ~i, —s, or —t 
options was given the first argument is taken as the name of a file of commands to be executed. 
The shell opers this file, and saves its name for possible resubstitution by ‘$0’. Since many 
systems use either the standard version 6 or version 7 shells whose shell scripts are not compa- 
tible with this shell, the shell will execute such a ‘standard’ shell if the first character of a script 
is not a ‘#’, i.e. if the script does not start with a comment. Remaining arguments initialize the 
variable argv. 
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Signal handling 


The shell normally ignores quit signals. Jobs running detached (either by ‘&* or the bgor %... 
& commands) are immune to signals generated from the keyboard, including hangups. Other 
Signals have the values which the shell inherited from its parent. The shells handling of inter- 
rupts and terminate signals in shell scripts can be controlled by oninm. Login shells catch the 
terminate signal, otherwise this signal is passed on to children from the state in the shell's 
parent. In no case are interrupts allowed when a login shell is reading the file ‘.logout’. 


AUTHOR 


William Joy. Job control and directory stack features first implemented by J.E. Kulp of 
.1.A.S.A, Laxenburg, Austria, with different syntax than that used now. 


FILES 
“/.eshre Read at beginning of execution by each shell. 
“/ Jogin Read by login shell, after ‘.cshrc’ at login. 
“/ logout Read by login shell, at logout. 
{bin/sh . Standard shel, for shell scripts not starting with a ‘#’. 
/tmp/she Temporary file for ‘<<’. 
/etc/passwd Source of home directories for ‘“name’. 

LIMITATIONS 
Words can be no longer than 1024 characters. The system limits argument lists to 10240 char- 
acters. The number of arguments to a command which involves filename expansion is limited 
to 1/6’th the number of characters allowed in an argument list. Command substitutions may 
substitute mo more characters than are allowed in an argument list. To detect looping, the shell 
restricts the number of alias substititutions on a single line to 20. 

SEE ALSO 
sh(1), newesh(1), access(2), exec(2), fork(2), killpg(2), pipe(2), sigsys(2), umask(2), 
viimit(2), wait(2), jobs(3), sigset(3), tty(4), a.out(5), environ(5), ‘An introduction to the C 
shell’ 

BUGS 


When a command is restarted from a stop, the shell prints the directory it started in if this is 
different from the current directory; this can be misleading (i.e. wrong) as the job may have 
changed directories internally. 


Shell builtin functions are not stoppable/restartable. Command sequences of the form ‘a; b,; 
c’ are also not handled gracefully when stopping is attempted. If you suspend ‘b’, the shell will 
then immediately execute ‘c’. This is especially noticeable if this expansion results from an 
alias. It suffices to place the sequence of commands in ()’s to force it to a subshell, i.e. ‘(a:b 
ec): 

Control over tty output after processes are started is primitive, perhaps this will inspire some- 
one to work on a good virtual terminal interface. In a virtual terminal interface much more 
interesting things could be done with output control. 


Alias. substitution is most often used to clumsily simulate shell procedures; shell procedures 
should be provided rather than aliases. 


Commands within loops, prompted for by ‘?’, are not placed in the Aistory list. Control struc- 
ture should be parsed rather than being recognized as built-in commands. This would allow 
control commands to be placed anywhere, to be combined with ‘P, and to be used with ‘&’ and 
*:” metasyntax. 


It should be possible to use the ‘:’ modifiers on the output of command substitutions. All and 
more than one ‘:’ modifier should be allowed on ‘S’ substitutions. 


1-66 


Ae bn i. ee PwmBe i. 


he APART A 2 Witla FIVUEPEIMINC! 5 Wianidl Ww FAKTO (U1) 


NAME 


ctags — create a tags file 


SYNOPSIS 


etags [ -~u] [ ~v}] [ ~w] [ —x] name... 


DESCRIPTION 


FILES 


Ciags makes a tags file for ex(1) from the specified C, Pascal and Fortran sources. A tags file 
gives the locations of specified objects (in this case functions) in a group of files. Each line of 
the tags file contains the function name, the file in which it is defined, and a scanning pattern 
used to find the function definition. These are given in separate fields on the line, separated by 
blanks or tabs. Using the cags file, excan quickly find these function definitions. 


If the —x flag is given, ctags produces a list of function names, the line number and file name 
on which each is defined, as well as the text of that line and prints this on the standard output. 
This is a simple index which can be printed out as an off-line readable function index. 


If the —v flag is given, an index of the form expected by vgrind(1) is produced on the standard 
output. This listing contains the function name, file name, and page number (assuming 64 line 
pages). Since the output will be sorted into lexicographic order, it may be desired to run the 
output through sort —f. Sample use: 

ctags —v files |sort —f > index 

vgrind —x index 


Files whose name ends in .c or .h are assumed to be C source files and are searched for C rou- 
tine and macro definitions. Others are first examined to see if they contain any Pascal or For- 
tran routine definitions, if not, they are processed again looking for C definitions. 


Other options are: 
—w suppressing warning diagnostics. 


—w causing the specified files to be updated in tags, that is, all references to them are deleted, 
and the new values are appended to the file. (Beware: this option is implemented in a 
way which is rather slow; it is usually faster to simply rebuild the sags file.) 


The tag main is treated specially in C programs. The tag formed is created by prepending M to 
the narne of the file, with a trailing .c removed, if any, and leading pathname components also 
removed. This makes use of crags practical in directories with more than one program. 


tags output tags file 


SEE ALSO 


ex(1), vid1) 


AUTHOR 


BUGS 
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Ken Arnold; FORTRAN added by Jim Kleckner, Bill Joy added Pascal and —x, replacing cxre/f. 


Recognition of functions, subroutines and procedures for FORTRAN and Pascal is done is a 
very simpleminded way. No attempt is made to deal with block structure; if you have two Pas- 
cal procedures in different blocks with the same name you lose. 


The method of deciding whether to look for C or Pascal and FORTRAN functions is a hack. 
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NAME 7 

cu — call UNIX 
SYNOPSIS 

cu telno [ —t] [ —nl —sspeed ] [ ~aacu] [ —I line] [ —b] 
DESCRIPTION 


Cu calls up another UNIX system, a terminal, or possibly a non-UNIX system. It manages an 
interactive conversation with possible transfers of text files. Telno is the telephone number, 
with minus signs at appropriate places for delays. The —t flag is used to dial out to a terminal. 
Speed gives the transmission speed (110, 134, 150, 300, 1200); 300 is the default value. 


The —aand —! values may be used to specify pathnames for the ACU and communications 
line devices. They can be used to override the following built-in choices: 


—a/dev/cua0 —1/dev/culd 


The —znoption, where mis a single digit, changes the last character of the ACU and communi- 
cations line to nm. It is an abbreviation for ~a /dev/cuan —1 /dev/culn. 


After making the connection, cu runs as two processes: the send process reads the standard 
input and passes most of it to the remote system; the receive process reads from the remote sys- 
tem and passes most data to the standard output. Lines beginning with ‘~ have special mean- 
ings. 


The send process interprets the following: 


: terminate the conversation. 
“EOT 


terminate the conversation 

” < file send the contents of //e to the remote system, as though typed at the ter- 
minal. 

“Z | suspend the cu process. Note that the control-Z must be followed bya 
newline. 

“# sends a break. 

“ | invoke an interactive shell on the local system. 

“lomd ... run the command on the local system (via sh —c). 

“$crmd ... run the command locally and send its output to the remote system. 


“%take from [to] 


“%put from [to] 


copy file ‘from’ (on the remote system) to file ‘to’ on the local system. If 
‘to’ is omitted, the ‘from’ name is used both places. 


copy file ‘from’ (on local system) to file ‘to’ on remote system. If ‘to’ is 
omitted, the ‘from’ name is used both places. 


during an output diversion, this toggles whether the operation of cu will be 
silent, i.e., whether information received from the foreign system will be 
written to the standard output. This allows a ‘‘progress report’ during long 
transfers. 


% 


send the line *~...’. 


Both the sendand receive processes handles output diversions of the following form: 


“>[>][] file 


zero or more lines to be written to file 


> 


In any case, output is diverted (or appended, if ‘> >° used) to the file. If ‘:’ is used, the diver- 
sion is silent, i.e., it is written only to the file. If ‘: is omitted, output is written both to the file 
and to the standard output. The trailing ‘“>’° terminates the diversion. 
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The use of ““put requires stty and carton the remote side. It also requires that the current 


erase and kill characters on the remote system be identical to the current ones on the local sys- 
tem. Backslashes are inserted at appropriate places. | 


The use of “take requires the existence of echo and tee on the remote system. Also, stty tabs 
mode is required on the remote system if tabs are to be copied without expansion. 


Finally, the —b flag specifies that nulls are to be turned into breaks. This allows the break key 
(and also control-shift-@) to send a break. 


FILES 
/dev/cua0 
/dev/culO 
/dev/null 
/usr/spool/uucp/LCK..cu[al] [0-7] 
SEE ALSO 
rv(4), tty (4) 
DIAGNOSTICS 
Exit code is zero for normal exit, nonzero (various values) otherwise. 
BUGS 
Only mail(1) uses syntax anything like the syntax of cu. 
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NAME : 
date — print and set the date 


SYNOPSIS | 
date [ yymmddhhmm [.ss } ] 


DESCRIPTION 

If no argument is given, the current date and time are printed. If an argument is given, the 
current date is set. yy is the last two digits of the year; the first mm is the month number; dd is 
the day number in the month; AA is the hour number (24 hour system); the second mm is the 
minute number; .ss is optional and is the seconds. For example: | 


“¢ date 10080045 


sets the date to Oct 8, 12:45 AM. The year, month and day may be omitted, the current values 
being the defaults. The system operates in GMT. Date takes care of the conversion to and 
from local standard and daylight time. 


FILES 
/usr/adm/wtmp to record time-setting 


SEE ALSO 
utmp(5) 
DIAGNOSTICS | 
‘No permission’ if you aren’t the super-user and you try to change the date; ‘bad conversion’ if 
the date set is syntactically incorrect. 
BUGS 
The system attempts to keep the date in a format closely compatible with VMS. VMS, how- 


ever, uses local time (rather than GMT) and does not understand daylight savings time. Thus 
if you use both UNIX and VMS, VMS will be running on GMT. 
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de — desk calculator 


SYNOPSIS 
de [ file ] 


De is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but 
one may specify an input base, output base, and a number of fractional digits to be maintained. 
The overall structure of de is a stacking (reverse Polish) calculator. If an argument is given, 


input is taken from that file until its end, then from the standard input. The following con- 
structions are recognized: 


number 


The value of the number is pushed on the stack. A number is an unbroken string of the 
digits 0-9. It may be preceded by an underscore _ to input a negative number. Numbers 
may contain decimal points. 

-—-/*%h” 
The top two values on the stack are added (+), subtracted (—), multiplied (*°), divided 
(/), remaindered (%), or exponentiated (“). The two entries are popped off the stack; 


the result 1s pushed on the stack in their place. Any fractional part of an exponent is 
ignored. 


SX The top of the stack is popped and stored into a register named x, where x may be any 
character. If the s is capitalized, x is treated as a stack and the value is pushed on it. 


ges. lx The value in register x is pushed on the stack. The register xis not altered. All registers 
start with zero value. If the | is capitalized, register x is treated as a stack and its top 
value is popped onto the main stack. 


a The top value on the stack is duplicated. 

i) The top value on the stack is printed. The top value remains unchanged. P interprets 
the top of the stack as an ascii string, removes it, and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recursion level is popped by two. If q is 


capitalized, the top value on the stack is popped and the string execution level is popped 
by that value. 


Xx treats the top element of the stack as a character string and executes it as a string of dc 
commands. 
A replaces the number on the top of the stack with its scale factor. 


[...] puts the bracketed ascii string onto the top of the stack. 
XX OX 


The top two elements of the stack are popped and compared. Register x is executed if 
they obey the stated relation. 


¥ replaces the top element on the stack by its square root. Any existing fractional part of 
the argument is taken into account, but otherwise the scale factor is ignored. 

: interprets the rest of the line as a UNIX command. 

¢ All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix for further input. I 
pushes the input base on the top of the stack. 

0 The top value on the stack is popped and used as the number radix for further output. 
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pushes the output base on the top of the stack. 


the top of the stack is popped, and that value is used as a non-negative scale factor: the 
appropriate number of places are printed on output, and maintained during multiplica- 
tion, division, and exponentiation. The interaction of scale factor, input base, and out- 
put base will be reasonable if all are changed together. 


The stack level is pushed onto the stack. 
replaces the number on the top of the stack with its length. 


A line of input is taken from the input source (usually the terminal) and executed. 


are used by dc for array operations. 


An example which prints the first ten values of n! is 


SEE ALSO 


[lal +dsa*plal0>ylsy 
Osal 
lyx 


be(1), which is a preprocessor for dc providing infix notation and a C-like syntax which imple- 


ments functions and reasonable control structures for programs. 


DIAGNOSTICS 
‘x is unimplemented’ where x is an octal number. 
‘stack empty’ for not enough elements on the stack to do what was asked. 
‘Out of space’ when the free list is exhausted (too many digits). 
‘Out of headers’ for too many numbers being kept around. 
‘Out of pushdown’ for too many items on the stack. 
‘Nesting Depth’ for too many levels of nested execution. 
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dd — convert and copy a file 
SYNOPSIS 
dd [option value] ... 
DESCRIPTION 
Dd copies the specified input file to the specified output with possible conversions. The stan- 


dard input and output are used by default. The input and output block size may be specified to 
take advantage of raw physical I/O. 


option values 

if = input file name; standard input is default 

of = output file name; standard output is default 

ibs = 71 input block size n bytes (default 512) 

obs =n output block size (default 512) 

bs™ 7 set both input and output block size, superseding ibs and ods; also, if no 
conversion is specified, it is particularly efficient since no copy need be done 

cbs =n conversion buffer size 

Skip = 1 skip # input records before starting copy 

files = n skip nm input files before starting copy 

seek = 7 seek vm records from beginning of output file before copying 

count =n copy only ” input records 


CONV ™* 4SCil 


convert EBCDIC to Bae lI 


slightly aie map f AS | 
ariable length records to fixed length 

unblock f ength records to variable length 

case map alphabe fe to lower case 

ucase map alphabetics to upper case 

swab swap every pair of bytes 

noerror do not stop processing on an 

sync pad every input record to ibs 

ye. Several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may end with k, b or w to 


specify multiplication by 1024, 512, or 2 respectively, a pair of numbers may be separated by x 
to indicate a product. 


Cés is used only if ascii, unblock, ebcdic, ibm, or block conversion is specified. In the first two 
cases, cos characters are placed into the conversion buffer, any specified character mapping is 
done, trailing blanks trimmed and new-line added before sending the line to the output. In the 
atter three cases, characters are read into the conversion buffer, and blanks added to make up 
an output record of size cbs. 


After completion, dd reports the number of whole and partial input and output blocks. 


For example, to read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into 
the ASCII file x: 


dd if=/dev/rmt0 of =x ibs = 800 cbs=80 conv ascii, icase 


Note the use of raw magtape. Dd is especially suited to [/O on the raw physical devices because 
it allows reading and writing in arbitrary record sizes. 
ep(1), tr(1) 
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~ DIAGNOSTICS 
f+p records in(out): numbers of full and partial records read(written) 
BUGS | | 
The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM 
Nov, 1968. The ‘ibm’ conversion, while less blessed as a standard, corresponds better to cer- 
tain IBM print train conventions. There is no universal solution. 
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NAME 

deroff - remove nroff, troff, tbl and eqn constructs 
SYNOPSIS 

deroff { —w ] file ... 
DESCRIPTION 


Deroff reads each file in sequence and removes all nroffand troffcommand lines, backslash con- 
structions, macro definitions, eqn constructs (between ‘.EQ’ and ‘.EN’ lines or between delim- 
iters), and table descriptions and writes the remainder on the standard output. Deroff follows 
chains of included files (‘.so’ and ‘.nx’ commands); if a file has already been included, a ‘.so’ is 


ignored and a ‘.nx’ terminates execution. If no input file is given, deroff reads from the stan- 
dard input file. 


if the —w flag is given, the output is a word list, one ‘word’ (string of letters, digits, and apos- 
trophes, beginning with a letter; apostrophes are removed) per line, and all other characters 
ignored. Otherwise, the output follows the original, with the deletions mentioned above. 

SEE ALSO 
troff(1), eqn(1), tbiG) 


BUGS 


Derof is not a complete troff interpreter, so it can be confused by subtle constructs. Most 
errors result in too much rather than too little output. 


sa 
a 

“nd 

CP) 
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NAME | 

df — disk free 
SYNOPSIS 

df { —i] { —1] [ filesystem ... ] [ file ... ] 
DESCRIPTION 


Df prints out the number of free blocks available on the specified filesystem, e.g. ‘‘/dev/rp0a’’, 
or on the filesystem in which the specified fle, e.g. ‘““SHOME”’ in contained. If no file system 
is specified, the free space on all of the normally mounted file systems is printed. 


The reported numbers are in file system block units; currently each filesystem block is 1024 
bytes long, twice the size of the blocks reported by du(1) or /s(1) with the —s option. 


Other options are: 


—j Report also the number of inodes which are used and free. 
—| examines also the free list, double checking that the summary number in the filesystem 
superblock is correct. | : 
FILES 
/etc/fstab list of normally mounted filesystems 
SEE ALSO 


fstab(5), icheck(8), quot(8) 
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NAME 

diction,explain — print wordy sentences; thesaurus for diction 
SYNOPSIS 

diction [ —ml ] [ ~—mm] [—n] { -f pfile ] file ... 

explain 
DESCRIPTION 


Diction finds all sentences in a document that contain phrases from a data base of bad or wordy 
diction. Each phrase is bracketed with [ ]. Because diction runs deroff before looking at the 
text, formatting header files should be included as part of the input. The default macro package 
—ms may be overridden with the flag -~mm. The flag —ml which causes deroff to skip lists, 
should be used if the document contains many lists of non-sentences. The user may supply 
her/his own pattern file to be used in addition to the default file with —f pfile. If the flag —n is 
also supplied the default file will be suppressed. 


Explain is an interactive thesaurus for the phrases found by diction. 


SEE ALSO 
deroff(1) 


BUGS 


Use of non-standard formatting macros may cause incorrect sentence breaks. In particular, dic- 
tion doesn’t grok —me. 
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NAME 
diff — differential file and directory comparator 

SYNOPSIS 
dif ( —~1} [ —r]) [ —s] { —cefh) [ —b] dirl dir2 
diff { ~cefh 1 { —b] file] file2 
diff { —~Dswing}) | -—b] filel file2 

DESCRIPTION | 
if both arguments are directories, dif sorts the contents of the directories by name, and then 
runs the regular file dif algorithm (described below) on text files which are different. Binary 
files which differ, common subdirectories, and files which appear in only one directory are 
listed. Options when comparing directories are: 


cal | long output format; each text file dif is piped through pr(1) to paginate it, other 
differences are remembered and summarized after all text file differences are reported. 


al 9 causes application of diffrecursively to common subdirectories encountered. 
—§ causes diffto report files which are the sarne, which are otherwise not mentioned. 


starts a directory diffin the middie beginning with file name. 


When run on regular files, and when comparing text files which differ during directory com- 
parison, difftells what lines must be changed in the files to bring them into agreement. Except 
in rare circumstances, diff finds a smallest sufficient set of file differences. If neither file] nor 
file2 is a directory, then either may be given as ‘--’, in which case the standard input is used. 
If file] is a directory, then a file in that directory whose file-name is the same as the file-name 
of file2 is used (and vice versa). 


There are several options for output format; the default output format contains lines of these 
forms: 


ala n3,nd4 
nl,n2da az 
ni,n2c n3,n4 


These lines resemble ed commands to convert fle/ into file2. The numbers after the letters 
pertain to file2. In fact, by exchanging ‘a’ for ‘d’ and reading backward one may ascertain 
equally how to convert file? into filel. As in ed, identical pairs where al = n2or nz ™ nd are 
abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file flagged by ‘<’, 

then all the lines that are affected in the second file flagged by ‘>’. 

Except for —b, which may be given with any of the others, the following options are mutually 

exclusive: 

—@ producing a script of a, cand dcommands for the editor ed, which will recreate file2 
from file]. In connection with —e, the following shell program may help maintain 
multiple versions of a file. Only an ancestral file ($1) and a chain of version-to- 
version edscripts ($2,$3,...) made by diffneed be on hand. A ‘latest version’ appears 
on the standard output. 

(shift; cat $*; echo ‘1,$p’) | ed ~ $1 
Extra commands are added to the output when comparing directories with —e, so 
that the result is a sh(1) script for converting text files which are common to the two 
directories from their state in dir/ to their state in dir2. 


-f produces a script similar to that of —e, not useful with ed, and in the opposite order. 
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—¢ produces a diff with lines of context. The default is to present 3 lines of context and 
may be changed, e.g to 10, by —c10. With —c the output format is modified slightly: 
the output beginning with identification of the files involved and their creation dates 
and then each change is separated by a line with a dozen *’s. The lines removed 
from file] are marked with ‘—’; those added to file2 are marked ‘+’. Lines which are 
changed from one file to the other are marked in both files with ‘!’. 

—h does a fast, half-hearted job. It works only when changed stretches are short and well 
separated, but does work on files of unlimited length. 

— Dstring 
causes diffto create a merged version of filel and file2 on the standard output, with C 
preprocessor controls included so that a compilation of the result without defining 

string is equivalent to compiling /lle/, while defining szring will yield file2. 

—b causes trailing blanks (spaces and tabs) to be ignored, and other strings of blanks to 

| compare equal. 
FILES 

/tmp/d????? 

/usr/lib/diffh for —h 

/usr/bin/pr 

SEE ALSO 


cmp(1), ce(1), comm(1), ed(1), diff3(1) 


DIAGNOSTICS 


Exit status is 0 for no differences, 1 for some, 2 for trouble. 


BUGS 


Editing scripts produced under the ~eor —f option are naive about creating lines consisting of 
a single °.’. 


When comparing directories with the —b option specified, dif first compares the files ala cmp, 
and then decides to run the diffalgorithm if they are not equal. This may cause a small amount 
of spurious output if the files then turn out to be identical because the omly differences are 
insignificant blank string differences. 
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NAME 


diff3 — 3-way differential file comparison 


SYNOPSIS 


diffs { —ex3 } file1 file2 file3 


DESCRIPTION 


FILES 


Diff? compares three versions of a file, and publishes disagreeing ranges of text flagged with 
these codes: 


am me a ome all three files differ 
ser wu: sox om | filel is different 
= ss on om) file2 is different 
we me am an 3 files is different 


The type of change suffered in converting a given range of a given file to some other is indi- 
cated in one of these ways: 


f:nla Text is to be appended after line number v/ in file f where f= 1, 2, or 3. 


finl,n2e Text is to be changed in the range line 7J/ to line n2. If al = n2, the range 
may be abbreviated to al. 


The original contents of the range follows immediately after a ¢ indication. When the contents 
of two files are identical, the contents of the lower-numbered file is suppressed. 


Under the —e option, diff? publishes a script for the editor ed that will incorporate into flle/ ail 
changes between /ile2 and fille3, i.e. the changes that normally would be flagged === = and 
mma} Option —x (—3) produces a script to incorporate only changes flagged === = 
(= = == = 3). The following command will apply the resulting script to ‘file!’. 


(cat script; echo ‘1,$p’) | ed — filel 


/usr/lib/diff3 


SEE ALSO 


BUGS 


diff (1) 


Text lines that consist of a single ‘.’ will defeat ~e. 
Files longer than 64K bytes won’t work. 
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NAME 

du — summarize disk usage 
SYNOPSIS 

du [ —s] [ ~a] [ name... ] 
DESCRIPTION 


Du gives the number of blocks contained in all files and (recursively) directories within each 
specified directory or file name. If name is missing, ‘.” is used. 


The optional argument —s causes only the grand total to be given. The optional argument —a 
causes an entry to be generated for each file. Absence of either causes an entry to be generated 
for each directory only. | 

A file which has two links to it is only counted once. 


SEE ALSO 
df(1), quor(8) 


BUGS 
Non-directories given as arguments (not under —a option) are not listed. 
If there are too many distinct linked files, du counts the excess files multiply. 
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NAME 

echo — echo arguments 
SYNOPSIS 

echo [ —n J [ arg } ... 
DESCRIPTION 


Echo writes its arguments separated by blanks and terminated by a newline on the standard out- 
put. If the flag ~n is used, no newline is added to the output. 


Echo is useful for producing diagnostics in shell programs and for writing constant data on 
pipes. To send diagnostics to the standard error file, do ‘echo ... 1>&2’. 
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ed — text editor 


SYNOPSIS 


ed {— ] { —plprompt] ] [ ~u] [ —x] [ name] 


DESCRIPTION 


Ed is the standard text editor. 


If a name argument is given, ed simulates an e command (see below) on the named file; that is 
to say, the file is read into ed’s buffer so that it can be edited. If —p is present, ed prompts for 
commands with ‘*’ (or prompt if given.) If —u is present, all lower case text in the buffer is 
converted to upper case. If -x is present, an x command is simulated first to handle an 
encrypted file. The optional — suppresses the printing of explanatory output and should be 
used when the standard input is an editor script. 


Ed operates on a copy of any file it is editing; changes made in the copy have no effect on the 
file until a w (write) command is given. The copy of the text being edited resides in a tem- 
porary file called the buffer. 


Commands to ed have a simple and regular structure: zero or more addresses followed by a sin- 
gle character command, possibly followed by parameters to the command. These addresses 
specify one or more lines in the buffer. Missing addresses are supplied by default. 


In general, only one command may appear on a line. Certain commands allow the addition of 
text to the buffer. While ed is accepting text, it is said to be in input mode. In this mode, no 
commands are recognized; all input is merely collected. Input mode is left by typing a period 
*, alone at the beginning of a line. 


Ed supports a limited form of regular expression notation. A regular expression specifies a set of 
strings of characters. A member of this set of strings is said to be matched by the regular 
expression. In the following specification for regular expressions the word ‘character’ means 
any character but newline. 


1. Any character except a special character matches itself. Special characters are the regu- 
lar expression delimiter plus \{. and sometimes ~*S. 


A. matches any character. 
A \ followed by any character except a digit or () matches that character. 


4, A nonempty string s bracketed [s] (or [*s]) matches any character in (or not in) s. In 
s, \ has no special meaning, and ] may only appear as the first letter. A substring a—3, 
with @ and din ascending ASCII order, stands for the inclusive range of ASCII charac- 
ters. 


a A regular expression of form 1-4 followed by * matches a sequence of 0 or more 
matches of the regular expression. 


A regular expression, x, of form 1-8, bracketed \(x\) matches what x matches. 


1 A \ followed by a digit » matches a copy of the string that the bracketed regular expres- 
sion beginning with the nth \( matched. 


8. A regular expression of form 1-8, x, followed by a regular expression of form 1-7, »y 
matches a match for x followed by a match for y, with the x match being ; as long as pos- 
sible while still permitting a y match. 


9. A regular expression of form 1-8 preceded by ~ (or followed by $), is constrained to 
matches that begin at the left (or end at the right) end of a line. 
10. A regular expression of form 1-9 picks out the longest among the leftmost matches ina 
line. 
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11. An empty regular expression stands for a copy of the last regular expression encoun- 
tered. 


Regular expressions are used in addresses to specify lines and in one command (see s below) 
to specify a portion of a line which is to be replaced. If it is desired to use one of the regular 
expression metacharacters as an ordinary character, that character may be preceded by ‘\’. This 
also applies to the character bounding the regular expression (often ‘/’) and to ‘\? itself. 


To understand addressing in ed it is necessary to know that at any time there is a current line. 
Generally speaking, the current line is the last line affected by a command; however, the exact 
effect on the current line is discussed under the description of the command. Addresses are 
constructed as follows. 


l. The character ‘.’ addresses the current line. 

2 The character ‘$’ addresses the last line of the buffer. 

S. A decimal number n addresses the n-th line of the buffer. 

“ “x addresses the line marked with the name x, which must be a lower-case letter. 


Lines are marked with the k command described below. 


>. A regular expression enclosed in slashes ‘/’ addresses the line found by searching for- 
ward from the current line and stopping at the first line containing a string that matches 
the regular expression. If necessary the search wraps around to the beginning of the 
buffer. 


6. A regular expression enclosed in queries °?’ addresses the line found by searching back- 
ward from the current line and stopping at the first line containing a string that matches 
the regular expression. If necessary the search wraps around to the end of the buffer. 


4 


L An address followed by a plus sign ‘+’ or a minus sign ‘—’ followed by a decimal 
number specifies that address plus (resp. minus) the indicated number of lines. The ae 
plus sign may be omitted. " 


8. If an address begins with ‘+’ or ‘—’ the addition or subtraction is taken with respect to 
the current line; e.g. ‘5° is understood to mean ‘.--5’. 


9, If an address ends with ‘+’ or ‘~—’, then 1 is added (resp. subtracted). As a conse- 
quence of this rule and rule 8, the address ‘—’ refers to the line before the current line. 
Moreover, trailing ‘+’ and ‘—’ characters have cumulative effect, so ‘~—’ refers to 
the current line less 2. 


10. To maintain compatibility with earlier versions of the editor, the character ‘~’ in 


addresses is equivalent to ‘— 


Commands may require zero, one, or two addresses. Commands which require no addresses 
regard the presence of an address as an error. Commands which accept one or two addresses 
assume default addresses when insufficient are given. If more addresses are given than such a 
command requires, the last one or two (depending on what is accepted) are used. 


Addresses are separated from each other typically by a comma ‘,’. They may also be separated 
by a semicolon ‘;’. In this case the current line ‘.’ is set to the previous address before the 
next address is interpreted. This feature can be peed to determine the starting line for forward 
and backward searches (‘/’, ‘9’). The second address of any two-address sequence must 
correspond to a line following the line corresponding to the first address. The special form ‘%’ 
is an abbreviation for the address pair ‘1,3’. 


In the following list of ed commands, the default addresses are shown in parentheses. The 
parentheses are not part of the address, but are used to show that the given addresses are the 
defauit. 
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As mentioned, it is generally illegal for more than one command to appear on a line. However, 
most commands may be suffixed by ‘p’ or by ‘I’, in which case the current line is either printed 
or listed respectively in the way discussed below. Commands may also be suffixed by ‘n’, 
meaning the output of the command is to be line numbered. These suffixes may be combined 
in any order. 

(.)a 

<text> 


The append command reads the given text and appends it after the addressed line. ‘.’ is 
left on the last line input, if there were any, otherwise at the addressed line. Address ‘0’ 
is legal for this command; text is placed at the beginning of the buffer. 

Cae 

<text> 


The change command deletes the addressed lines, then accepts input text which replaces 
these lines. ‘.’ is left at the last line input; if there were none, it is left at the line preced- 
ing the deleted lines. 

( © 9 6 ) d 
The delete command deletes the addressed lines from the buffer. The line originally after 


the last line deleted becomes the current line; if the lines deleted were originally at the 
end, the new last line becomes the current line. 


e filename 
The edit command causes the entire contents of the buffer to be deleted, and then the 
named file to be read in. ‘.’ is set to the last line of the buffer. The number of characters 


read is typed. ‘filename’ is remembered for possible use as a default file name in a subse- 
quent ror wcommand. If ‘filename’ is missing, the remembered name is used. 


E filename 
This command is the same as e, except that no diagnostic results when no w has been 
given since the last buffer alteration. 

f filename 


The filename command prints the currently remembered file name. If ‘filename’ is given, 
the currently remembered file name is changed to ‘filename’. 


(1,$) g/regular expression/command list 

In the global command, the first step is to mark every line which matches the given regu- 
lar expression. Then for every such line, the given command list is executed with *.’ ini- 
tially set to that line. A single command or the first of multiple commands appears on the 
same line with the global command. All lines of a multi-line list except the last line must 
be ended with ‘\’. A, i, and c commands and associated input are permitted; the ‘.’ ter- 
minating input mode may be omitted if it would be on the last line of the command list. 
The commands g and v are not permitted in the command list. 


(.)i 
<text> 


This command inserts the given text before the addressed line. ‘.’ is left at the last line 
input, or, if there were none, at the line before the addressed line. This command differs 
from the a command only in the placement of the text. 


(.,.+1)j 


This command joins the addressed lines into a single line; intermediate newlines simply 
disappear. ‘.’ is left at the resulting line. 
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(.)kx 
The mark command marks the addressed line with name x, which must be a lower-case 
letter. The address form ‘x then addresses this line. 


Caste) | 
The list command prints the addressed lines in an unambiguous way: non-graphic charac- 
ters are printed in two-digit octal, and long lines are folded. The / command may be 
placed on the same line after any non-i/o command. 
(.,.)ma 
The move command repositions the addressed lines after the line addressed by a. The 
last of the moved lines becomes the current line. 
Coie ei 
The number command prints the addressed lines with line numbers and a tab at the left. 
(.,.)p 
The print command prints the addressed lines. ‘.’ is left at the last line printed. The p 
command may be placed on the same line after any non-i/o command. 


(.,.)P 
This command is a synonym for p. 


q The quit command causes ed to exit. No automatic write of a file is done. 


Q This command is the same as g, except that no diagnostic results when no w has been 
given since the last buffer alteration. 


($) r filename 
The read command reads in the given file after the addressed line. If no file name is 
given, the remembered file name, if any, is used (see e and fcommands). The file name 
is remembered if there was no remembered file name already. Address ‘0’ is legal for - 
uses the file to be read at the see of the buffer. If the read is successful, the 
number of characters read is typed. ‘.’ is left at the last line read in from the file. 


(.,.)s/reguiar expression/replacement/ or, 

( .,.)s/regular expression/replacement/g 
The substitute command searches each addressed line for an occurrence of the specified 
regular expression. On each line in which a match is found, all matched strings are 
replaced by the replacement specified, if the global replacement indicator ‘g’ appears after 
the command. If the global indicator does not appear, only the first occurrence of the 
matched string is replaced. It is an error for the substitution to fail on all addressed lines. 
Any punctuation character may be used instead of ‘/’ to delimit the regular expression 
and the replacement. *.’ is left at the last line substituted. 


An ampersand ‘&’ appearing in the replacement is replaced by the string matching the 
regular expression. The special meaning of ‘&’ in this context may be suppressed by 
preceding it by ‘\’. The characters ‘1’ where ” is a digit, are replaced by the text 
matched by the n-th regular subexpression enclosed between ‘\( and ‘\)’. When nested, 
parenthesized subexpressions are present, 1 is determined by counting occurrences of ‘\( 
starting from the left. 


Lines may be split by substituting new-line characters into them. The new-line in the 
replacement string must be escaped by preceding it by ‘\’. 


One or two trailing delimiters may be omitted, implying the ‘p’ suffix. The special form 
‘s’ followed by avo delimiters repeats the most recent substitute command on the 
addressed lines. The ‘s’ may be followed by the letters r (use the most recent regular 
expression for the left hand side, instead of the most recent left hand side of a substitute 
command), p (complement the setting of the p suffix from the previous substitution), or 
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g (complement the setting of the g suffix). These letters may be combined in any order. 
(.,.)ta 
This command acts just like the m command, except that a copy of the addressed lines is 
placed after address a (which may be 0). ‘.’ is left on the last line of the copy. 
Cras 7) 
The undo command restores the buffer to it’s state before the most recent buffer modify- 
ing command. The current line is also restored. Buffer modifying commands are a, ¢, d, 


g, i, k, and v. For purposes of undo, g and v are considered to be a single buffer modifying 
command. Undo is its own inverse. 


When ed runs out of memory (at about 8000 lines on any 16 bit mini-computer such as 
the PDP-11) This full undo is not possible, and u can only undo the effect of the most 
recent substitute on the current line. This restricted unto also applies to editor scripts 
when ed is invoked with the - option. 


(1, $) v/regular expression/command list 
This command is the same as the global command g except that the command list is exe- 
cuted g with ‘.’ initially set to every line except those matching the regular expression. 

(1, $) w filename 
The write command writes the addressed lines onto the given file. If the file does not 
exist, it is created. The file name is remembered if there was no remembered file name 
already. If no file name is given, the remembered file name, if any, is used (see e and f 
comumands). ‘.’ is unchanged. If the command is successful, the number of characters 
written is printed. ? 7 

(1, $) W filename 
This command is the same as w, except that the addressed lines are appended to the file. 

(1, $) wa filename 


This command is the same as w except that afterwards a g command is done, exiting the 
editor after the file is written. 


X A key string is demanded from the standard input. Later r, e and w commands will 
encrypt and decrypt the text with this key by the algorithm of crypr(1). An explicitly 
empty key turns off encryption. (.+1)z or, 

(.+1)za 
This command scrolls through the buffer starting at the addressed line. 22 (or a, if given) 
lines are printed. The last line printed becomes the current line. The value a is sticky, in 
that it becomes the default for future z commands. 


($) 
The line number of the addressed line is typed. ‘.’ is unchanged by this command. 


'<shell command> 
The remainder of the line after the ‘!’ is sent to sh(1) to be interpreted as a command. 
*.’ is unchanged. 

(.+1,.+1) <newline> 
An address alone on a line causes the addressed line to be printed. A blank line alone ts 
equivalent to ‘.+1p’; it is useful for stepping through text. If two addresses are present 


with no intervening semicolon, ed prints the range of lines. If they are separated by a 
semicolon, the second line is printed. 


If an interrupt signal (ASCII DEL) is sent, ed prints ‘?interrupted’ and returns to its command 
level. 
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Some size limitations: 512 characters per line, 256 characters per global command list, 64 char- 
acters per file name, and, on mini computers, 128K characters in the temporary file. The limit 
on the number of lines depends on the amount of core: each line takes 2 words. 


When reading a file, ed discards ASCII NUL characters and all characters after the last newline. 
It refuses to read files containing non-ASCII characters. 


/tmp/e* 
edhup: work is saved here if terminal hangs up 


SEE ALSO 


B. W. Kernighan, 4 Jurorial Introduction to the ED Text Editor 
B. W. Kernighan, Advanced editing on UNIX 
sed(1), crypt(1) 


DIAGNOSTICS 


BUGS 


‘?name’ for inaccessible file; ‘?self-explanitory message’ for other errors. 


To protect against throwing away valuable work, a g or e command is considered to be in error, 
unless a w has occurred since the last buffer change. A second g or e will be obeyed regardless. 


The /command mishandles DEL. 
The undo command causes marks to be lost on affected lines. 
The x command, -x option, and special treatment of hangups only work on UNIX. 
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NAME 

efl — Extended Fortran Language 
SYNOPSIS 

efi [ option ... ] [ filename ... ] 
DESCRIPTION 


Efi compiles a program written in the EFL language into clean Fortran. £/ff provides the same 
control flow constructs as does Ratfor (1), which are essentially identical to those in C: 
Statement grouping with braces; 
decision-making with if, if-else, and switch-case; while, for, Fortran do, repeat, and 
repeat...until loops; multi-level break and next. In addition, EFL has C-like data struc- 
tures, and more uniform and convenient input/output syntax, generic functions. EFL 
also provides some syntactic sugar to make programs easier to read and write: 
free form input: 
multiple statements/line; automatic continuation statement label names (not just 
numbers), 
comments: 
# this is a comment 


translation of relationals: 
>, >=, etc., become .GT., .GE., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 


include: 
include filename 


The Ef] command option —w suppresses warning messages. The option ~C causes comments 
to be copied through to the Fortran output (default); —# prevents comments from being 
copied through. If a command argument contains an embedded equal sign, that argument is 
treated as if it had appeared in an option statement at the beginning of the program. £77 is best 
used with /77(1). 

SEE ALSO 
{77(1), ratfor(1). 


S. I. Feldman, The Programming Language EFL, Bell Labs Computing Science Technical Report 
#78. 
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NAME 
eqn, neqn, checkeq — typeset mathematics 
SYNOPSIS 
eqn {[ ~dxy ] [—pn] [—sn] { -fn] [ file ] ... 
checkeg [ file } ... 
DESCRIPTION 


Eqn is a troff(1) preprocessor for typesetting mathematics on a Graphic Systems photo- 
typesetter, neqn on terminals. Usage is almost always 


eqn file ... | troff 
neqn file ... | nroff 


If no files are specified, these programs reads from the standard input. A line beginning with 
‘EQ’ marks the start of an equation; the end of an equation is marked by a line beginning with 
‘EN’. Neither of these lines is altered, so they may be defined in macro packages to get 
centering, numbering, etc. It is also possible to set two characters as ‘delimiters’; subsequent 
text between delimiters is also treated as egt input. Delimiters may be set to characters x and y 
with the command-line argument ~dxy or (more commonly) with ‘delim xy’ between .EQ and 
.EN. The left and right delimiters may be identical. Delimiters are turned off by ‘delim off’. 
All text that is neither between delimiters nor between .EQ and .EN is passed through 
untouched. 


The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 


Tokens within egn are separated by spaces, tabs, newlines, braces, double quotes, tildes or 
circumflexes. Braces {} are used for grouping; generally speaking, anywhere a single character 
like x could appear, a complicated construction enclosed in braces may be used instead. Tilde ~ 
represents a full space in the output, circumflex ~ half as much. 


Subscripts and superscripts are produced with the keywords sub and sup. Thus x sud i makes x,, 
a sub i sup 2 produces a,*, and e sup {x sup 2 + y sup 2} gives ext” - 
Fractions are made with over: a over 6 yields me 


sqrt makes square roots: / over sqrt {ax sup 2 +hx+c} results in — 
ax*+bx+#ec 


The keywords from and to introduce lower and upper limits on arbitrary things: lim 2x is 
| eetineed 0 
made with lim from (n-—> inf} sum from 0 to n x subi. 


Left and right brackets, braces, etc., of the right height are made with left and right: left [ x sup 
2 + y sup 2 over alpha right ] ~ =" I produces eee = 1. The right clause is optional. Legal 
characters after left and right are braces, brackets, bars, ¢ and f for ceiling and floor, and "" for 
nothing at all (useful for a right-side-only bracket). 

Vertical piles of things are made with pile, Ipile, cpile, and rpile: pile {a above b above c} pro- 


@ 
duces 6 There can be an arbitrary number of elements in a pile. Ipile left-justifies, pile and 


oe 


cpile center, with different vertical spacing, and rpile right justifies. 


Matrices are made with matrix: maztrix { Ico! { x sub i above y sub 2} ccol { I above 2} } pro- 
aj l ; , 
duces yn 2 In addition, there is rcol for a right-justified column. 
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Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: x dot = fT.) 
bar is x= f(t), y dotdot bar~ =" n underis y = n, and x vec” = y dyadis X = ¥. 


Sizes and font can be changed with size 7 or size +7, roman, italic, bold, and font vn. Size and 
fonts can be changed globally in a document by gsize n and gfont a, or by the command-line 
arguments ~smand —fn. 


Normally subscripts and superscripts are reduced by 3 point sizes from the previous size; this 
may be changed by the command-line argument —pz. 


Successive display arguments can be lined up. Place mark before the desired lineup point in 
the first equation; place lineup at the place that is to line up vertically in subsequent equations. 


Shorthands may be defined or existing keywords redefined with define. define thing % replace- 
ment % defines a new token called thing which will be replaced by replacement whenever it 
appears thereafter. The % may be any character that does not occur in replacement. 


Keywords like sum (}-) int ) inf (co) and shorthands like >= (2) -—> (-—), and != (#) 
are recognized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. 
Mathematical words like sin, cos, log are made Roman automatically. Troff(1) four-character 
escapes like \(bs (@)) can be used anywhere. Strings enclosed in double quotes "..." are passed 
through untouched; this permits keywords to be entered as text, and can be used to communi- 
cate with trof/ when all else fails. 


SEE ALSO 


BUGS 


7th Edition 


troff(1), tbl(1), ms(7), eqnchar(7) 
B. W. Kernighan and L. L. Cherry, Typesetting Mathematics— User's Guide 
J. F. Ossanna, NROFF/TROFF User's Manual 


To embolden digits, parens, etc., it is necessary to quote them, as in ‘bold "12.3"". 
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NAME | 
error ~ analyze and disperse compiler error messages 


SYNOPSIS : 
error {—n} [—s] [ —q] [ —v] [ —t suffixlist ] [ —I ignorefile }] { name ] 


DESCRIPTION 
Error analyzes and optionally disperses the diagnostic error messages produced by a number of 
compilers and language processors to the source file and line where the errors occurred. It can 
replace the painful, traditional methods of scribbling abbreviations of errors on paper, and per- 
mits error messages and source code to be viewed simultaneously without machinations of mul- 
tiple windows in a screen editor. 


Error looks at the error messages, either from the specified file name or from the standard 
input, and attempts to determine which language processor produced each error message, deter- 
mines the source file and line number to which the error message refers, determines if the - 
error message is to be ignored or not, and inserts the (possibly slightly modified) error message 
into the source file as a comment on the line preceeding to which the line the error message 
refers. Error messages which can’t be categorized by language processor or content are not 
inserted into any file, but are sent to the standard output. Error touches source files only after 
all input has been read. By specifying the —q query option, the user is asked to confirm any 
potentially dangerous (such as touching a file) or verbose action. Otherwise error proceeds on 
its merry business. If the ~t touch option and associated suffix list is given, error will restrict 
itself to touch only those files with suffices in the suffix list. Error also can be asked (by speci- 
fying -v) to invoke vi(1) on the files in which error messages were inserted; this obviates the 
need to remember the names of the files with errors. 


Error is intended to be run with its standard input connected via a pipe to the error message 
source. Some language processors put error messages on their standard error file; others put 
their messages on the standard output. Hence, both error sources should be piped together . 
into error. For example, when using the cs syntax, “ieee 


make —s lint |& error —q —v 


will analyze all the error messages produced by whatever programs make runs when making 
lint. 


Error knows about the error messages produced by: make, cc, cpp, ccom, as, Id, lint, pi, pe and 
S77. Error knows a standard format for error messages produced by the language processors, so 
is sensitive to changes in these formats. For all languages except Pascal, error messages are 
restricted to be on one line. Some error messages refer to more than one line in more than 
one files; error will duplicate the error message and insert it at all of the places referenced. 


Error will do one of six things with error messages. 


synchronize 
Some language processors produce short errors describing which file it is processing. 
Error uses these to determine the file name for languages that don’t include the file 
name in each error message. These synchronization messages are consumed entirely 
by error. 


discard __ Error messages from /ins that refer to one of the two /int libraries, /usr/lib/llib-ic and 
lusr/lib/ilib-port are discarded, to prevent accidently touching these libraries. Again, 
these error messages are consumed entirely by error. 


nullify Error messages from /int can be nullified if they refer to a specific function, which is 
known to generate diagnostics which are not interesting. Nullified error messages 
are not inserted into the source file, but are written to the standard output. The 
names of functions to ignore are taken from either the file named .errorrc in the 
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users’s home directory, or from the file named by the —I option. If the file does 


not exist, no error messages are nullified. If the file does exist, there must be one 
function name per line. 


not file specific 
Error messages that can’t be intuited are grouped together, and written to the stan- 


dard output before any files are touched. They will not be inserted into any source 
file. 


file specific Error message that refer to a specific file, but to no specific line, are written to the 
standard output when that file is touched. 


true errors Error messages that can be intuited are candidates for insertion into the file to which 
they refer. 


Only true error messages are candidates for inserting into the file they refer to. Other error 
messages are consumed entirely by error or are written to the standard output. Error inserts the 
error messages into the source file on the line preceeding the line the language processor found 
in error. Each error message is turned into a one line comment for the language, and is inter- 
nally flagged with the string ““###” at the beginning of the error, and ‘““%%%”’ at the end of 
the error. This makes pattern searching for errors easier with an editor, and allows the mes- 
sages to be easily removed. In addition, each error message contains the source line number 
for the line the message refers to. A reasonably formatted source program can be recompiled 
with the error messages still in it, without having the error messages themselves cause future 
errors. For poorly formatted source programs in free format languages, such as C or Pascal, it 
is possible to insert a comment into another comment, which can wreak havoc with a future 
compilation. To avoid this, format the source program so there are no language statements on 
the same line as the end of a comment. 


Options available with error are: 
—n Do nottouch any files; all error messages are sent to the standard output. 


—q The user is queried whether s/he wants to touch the file. A ‘‘v’’ or ‘‘n’’ to the question is 
necessary to continue. Absence of the —gq option implies that all referenced files (except 
those refering to discarded error messages) are to be touched. 


—y After all files have been touched, overlay the visual editor vi with it set up to edit all files 
touched, and positioned in the first touched file at the first error. If vi can't be found, try 
ex or ed from standard places. 


~t Take the following argument as a suffix list. Files whose suffices do not appear in the 
suffix list are not touched. The suff 


fix list is dot seperated, and ‘‘*”’ wildcards work. Thus 
the suffix list: 


" c.y.foo*.h” 
allows error to touch files ending with ‘‘.c’’, “S.y’’, ““.fooe”’ and ““.y”’. 
—s Print out staustics regarding the error categorization. Not too useful. 


Error catches interrupt and terminate signals, and if in the insertion phase, will orderly ter-— 
minate what it is doing. 


AUTHOR 


FILES 


Robert Henry 


~/.errorre function names to ignore for /int error messages 
/dev/tty user's teletype 
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BUGS 
Opens the teletype directly to do user querying. 


Source files with links make a new copy of the file with only one link to it. 


Changing a language processor’s format of error messages may cause error to not understand 
the error message. 


Error, since it is purely mechanical, will not filter out subsequent errors caused by ‘floodgating’ 
initiated by one syntactically trivial error. Humans are still much better at discarding these 
related errors. 


Pascal error messages belong after the lines affected (error puts them before). The alignment 
of the ‘|’ marking the point of error is also disturbed by error. 


Error was designed for work on CRT's at reasonably high speed. It is less pleasant on slow 
speed terminals, and has never been used on hardcopy terminais. 
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NAME 
ex, edit — text editor 


SYNOPSIS 


ex {— ][(—v][—t tag] {[—r] [ +command)] { ~—1] name... 
edit [ ex options ] 


DESCRIPTION 


Ex is the root of a family of editors: edit, ex and vi. Ex is a superset of ed, with the most notable 
extension being a display editing facility. Display based editing is the focus of wi. 


If you have not used ed, or are a casual user, you will find that the editor edit is convenient for 


you. It avoids some of the complexities of ex used mostly by systems programmers and per- 
sons very familiar with ed. 


If you have a CRT terminal, you may wish to use a display based editor; in this case see w(1), 
which is a command which focuses on the display editing portion of ex. 


DOCUMENTATION 


The document Edit: A tutorial provides a comprehensive introduction to edif assuming no previ- 
ous knowledge of computers or the UNIX system. 


The Ex Reference Manual — Version 3.5 is a comprehensive and complete manual for the com- 
mand mode features of ex, but you cannot learn to use the editor by reading it. For an intro- 
duction to more advanced forms of editing using the command mode of ex see the editing 
documents written by Brian Kernighan for the editor ed; the material in the introductory and 
advanced documents works also with ex. 


An Introduction to Display Editing with Vi introduces the display editor wi and provides reference 
material on w. All of these documents can be found in volume 2c of the Programmer's Manual. 
In addition, the Vi Quick Reference card summarizes the commands of w in a useful, functional 
way, and is useful with the /ntroduction. 


FILES 
/usr/lib/ex?.?strings error messages 
/usr/lib/ex?.? recover recover command 
/usr/lib/ex?.?preserve preserve command 
/etc/termcap describes capabilities of terminals 
“/.exre editor startup file 
/tmp/Exnnnan editor temporary 
/tmp/Rxannann named buffer temporary 
/usr/preserve preservation directory 
SEE ALSO 
awk(1), ed(1), grep(1), sed(1), grep(1), vil), termcap(5), environ(5) 
AUTHOR 


Originally written by William Joy 
Mark Horton has maintained the editor since version 2.7, adding macros, support for many 
unusual terminals, and other features such as word abbreviation mode. 

BUGS | | 
The undo command causes all marks to be lost on lines changed and then restored if the 
marked lines were changed. 
Undo never clears the buffer modified condition. 


The = command prints a number of logical rather than physical lines. More than a screen full 
of output may result if long lines are present. 
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File input/output errors don’t print a name if the command line ‘—’ option is used. 
There is no easy way to do a single scan ignoring case. 


The editor does not warn if text is placed in named buffers and not used before exiting the edi- 
tor. 


Null characters are discarded in input files, and cannot appear in resultant files. 
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NAME 
expand, unexpand — expand tabs to spaces, and vice versa 


SYNOPSIS 
expand [ —tabstop ] { —tabl,tab2,....tabn ] [ file... ] 
unexpand { —a ] [ file ... ] 


DESCRIPTION 
Expand processes the named files or the standard input writing the standard output with tabs 
changed into blanks. Backspace characters are preserved into the output and decrement the 
column count for tab calculations. Expand is useful for pre-processing character files (before 
sorting, looking at specific columns, etc.) that contain tabs. 


If a single tabstop argument is given then tabs are set tadstop spaces apart instead of the default 
8. If multiple tabstops are given then the tabs are set at those specific columns. 


Unexpand puts tabs back into the data from the standard input or the named files and writes the 
result on the standard output. By default only leading blanks and tabs are reconverted to maxi- 
mal strings of tabs. If the —a option is given, then tabs are inserted whenever they would 
compress the resultant file by replacing two or more characters. 


BUGS 
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NAME 

eyacc — modified yacc allowing much improved error recovery 
SYNOPSIS 

eyace [ —v ] [ grammar ] 
DESCRIPTION 


Eyacc is an old version of yacc(1), which produces tables used by the Pascal system and its 
error recovery routines. FEyacc fully enumerates test actions in its parser when an error token Is 
in the look-ahead set. This prevents the parser from making undesirable reductions when an 
error occurs before the error is detected. The table format is different in eyacc than it was in 
the old yacc, as minor changes had been made for efficiency reasons. 


SEE ALSO 
yacc(1) 
‘*Practical LR Error Recovery’? by Susan L. Graham, Charles B. Haley and W. N. Joy, SIG- 
PLAN Conference on Compiler Construction, August 1979. 


AUTHOR 
S. C. Johnson 


Eyacc modifications by Charles Haley and William Joy. 


BUGS 
Pc and its error recovery routines should be made into a library of routines for the new yacc. 


4th Berkeley Distribution 


F77 (1) 


UNIX Programmer's Manual FITC) 


NAME 

{77 — Fortran 77 compiler 
SYNOPSIS 

{77 | option } ... file ... 
DESCRIPTION 


F77is the UNIX Fortran 77 compiler. It accepts several types of arguments: 


Arguments whose names end with ‘.f are taken to be Fortran 77 source programs; they are 
compiled, and each object program is left on the file in the current directory whose name is that 
of the source with ‘.o° substituted for ’.f. 


Arguments whose names end with ‘.r’ or ‘.e’ are taken to be Ratfor or EFL source programs, 
respectively, these are first transformed by the appropriate preprocessor, then compiled by {77. 


In the same way, arguments whose names end with ‘.c’ or ‘.s’ are taken to be C or assembiy 
source programs and are compiled or assembled, producing a ‘.o’ file. 


The following options have the same meaning as in cc(1). See /d(1) for load-time options. 
—¢€ Suppress loading and produce ‘.o’ files for each source file. 


Have the compiler produce additional symbol table information for sdb(1). Also pass 
the ~lg flag to /d(1). 


-w Suppress all warning messages. If the option is ‘~w66', only Fortran 66 compatibility 
ings are suppressed. 


Prepare object files for profiling, see prof(1). 


Name the final allies file outpur instead of ‘aout’. 


~onetrip 
Compile DO loops that are performed at least once if reached. (Fortran 77 DO loops 
are not necormed at all if the upper limit is smaller than the lower limit.) 


—Y Make the default type of a variable ‘undefined’ rather than using the default Fortran 


rules. 
=-C Compile code to check that subscripts are within declared array bounds. 


=F Apply EFL and Raifor preprocessor to relevant files, put the result in the file with the 
suffix changed to ‘.f, but do not compile. 


-m Apply the M4 preprocessor to each ‘.r’ or ‘.e’ file before transforming it with the Ratfor 
or EFL preprocessor. 

~Ex Use the string xas an EFL option in processing ‘.e’ files. 

~Rx Use the string xas a Ratfor option in processing ‘.r’ files. 

Other arguments are taken to be either loader option arguments, or F77-compatible object pro- 

grams, typically produced by an earlier run, or perhaps libraries of F77-compatible routines. 


These programs, together with the results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name ‘a.out’. 


FILES 
file. [fresc] input file 
file.o object file 
a.out loaded output 
fusr/lib/f77passl compiler 
/lib/ fi pass Z 
flib/c2 optiona! optimizer 
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/usr/lib/libF77.a intrinsic function library 
/usr/lib/libl177.a Fortran I/O library 
/lib/libe.a C library, see section 3 
SEE ALSO . 
S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler 
prof(1), cc(1), 1d(1), efl(1), ratfor (1) 
DIAGNOSTICS 
The diagnostics produced by /77 itself are intended to be self-explanatory. Occasional messages 
may be produced by the loader. 


BUGS 


The Fortran 66 subset of the language has been exercised extensively, the newer features have 
not. 
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NAME 


file — determine file type 
file file ... 

DESCRIPTION , 
File performs a series of tests om each argument in an attempt to classify it. If an argument 
appears to be ascii, fle examines the first 512 bytes and tries to guess its language. 


BUGS 


It often makes mistakes. In particular it often suggests that command files are C programs. 
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NAME 
find — find files 


SYNOPSIS 


find pathname-list expression 

DESCRIPTION 
Find recursively descends the directory hierarchy for each pathname in the pathname-list (i.e., 
one or more pathnames) seeking files that match a boolean expression written in the primaries 


given below. In the descriptions, the argument vn is used as a decimal integer where +” means 
more than 7, —n means less than 7 and m means exactly z. 


—~name filenarne 


True if the flename argument matches the current file name. Normal Shell argu- 
ment syntax may be used if escaped (watch out for ‘(’, ‘?’ and ‘*’). 


— perm onum 


True if the file permission flags exactly match the octal number onum (see 
chmod(1)). If onum is prefixed by a minus sign, more flag bits (017777, see star(2)) 
become significant and the flags are compared: (fagskonum) = =onum. 


—typec True if the type of the file is c, where cis b, c, d or f for block special file, character 
special file, directory or plain file. 


~links n True if the file has 7 links. 
“user uname 

True if the file belongs to the user uname (login name or numeric user ID). 
“oroup gname | 

True if the file belongs to group gname (group name or numeric group ID). 


—sizen True if the file is 1 blocks long (512 bytes per block). 
~inumn True if the file has inode number n. 
~atime n True if the file has been accessed in ” days. 


—mitime n 
True if the file has been modified in 7 days. 

“exec command 
True if the executed command returns a zero value as exit status. The end of the 
command must be punctuated by an escaped semicolon. A command argument ‘{}’ 
is replaced by the current pathname. 

~ok command 


Like ~exee except that the generated command is written on the standard output, 
then the standard input is read and the command executed only upon response y. 


~print Always true; causes the current pathname to be printed. 
~newer file 
True if the current file has been modified more recently than the argument /le. 


The primaries may be combined using the following operators (in order of decreasing pre- 
cedence): | 


1) A parenthesized group of primaries and operators (parentheses are special to the Shell and 
must be escaped). | 
2) 


3) Concatenation of primaries (the and operation is implied by the juxtaposition of two pri- 
maries). 


The negation of a primary (‘!’ is the unary zo¢ operator). 
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4) Alternation of primaries (‘—o’ is the or operator). 


EXAMPLE 
To remove ail files named ‘a.out’ or ‘*.o’ that have not been accessed for a week: 


find / \( ~name a.out —o —name ’*.o’ \) —atime +7 —exec rm {} \; 


FILES 
/etc/passwd 
/etc/group 


SEE ALSO 
sh(1), test(1), filsys(5) 


BUGS 
The syntax is painful. 
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NAME 
finger — user information lookup program 

SYNOPSIS 
finger { options ] name ... 

DESCRIPTION . 
By default finger lists the login name, full name, terminal name and write status (as a ’*’ before 
the terminal name if write permission is denied), idle time, login time, and office location and 
phone number (if they are known) for each current UNIX user. (Idle time is minutes if it is a 
single integer, hours and minutes if a’:’ is present, or days and hours if a ’d’ is present.) 


A longer format also exists and is used by finger whenever a list of peoples names is given. 
(Account names as well as first and last names of users are accepted.) This format is multi-line, 
and includes all the information described above as well as the user’s home directory and login 
shell, any plan which the person has placed in the file .plan in their home directory, and the 
project on which they are working from the file .project also in the home directorv. 


Finger options include: 


—~m Match arguments only on user name. 


|} Force long output format. 
=H Suppress printing of the .plan files 


~—S Force short output format. 

FILES 
/etc/utmp who file 
/etc/passwd for users names, offices, ... 
/usr/adm/lastlog last login times 
~/.plan plans 
“/ project , projects 

SEE ALSO 
w(l), who(1) 

AUTHOR 
Earl T. Cohen 

BUGS 


Only the first line of the .project file is printed. 


The encoding of the gcos field is UCB dependent — it knows that an office ‘197MC’ is ‘197M 
Cory Hall’, and tht ‘S29BE’ is ‘529B Evans Hall’. 


A user information data base is in the works and will radically alter the way the information 
that finger uses is stored. Finger will require extensive modification when this is implemented. 
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NAME 
fmt — simple text formatter 


SYNOPSIS 
fmt [ name... ] 

DESCRIPTION 
Fmt is a simple text formatter which reads the concatenation of input files (or standard input if 
none are given) and produces on standard output a version of its input with lines as close to 72 
characters long as possible. The spacing at the beginning of the input lines is preserved in the 
output, as are blank lines and interword spacing. 


Fmt is meant to format mail messages prior to sending, but may also be useful for other simple 
tasks. For instance, within visual mode of the ex editor (e.g. vi) the command 

ime 
will reformat a paragraph, evening the lines. 


SEE ALSO 
nroff(1), mail(1) 


AUTHOR 
Kurt Shoens 

BUGS 
The program was designed to be simple and fast — for more complex operations, the standard 
text processors are likely to be more appropriate. 
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NAME 

fold — fold long lines for finite width output device 
SYNOPSIS 

fold { —width ] { file... ] 
DESCRIPTION 


Fold is a filter which will fold the contents of the specified files, or the standard input if no files 
are specified, breaking the lines to have maximum width width. The default for width is 80. 
Width should be a multiple of 8 if tabs are present, or the tabs should be expanded using 
expand(1) before coming to fold. 


SEE ALSO 
expand(1) 
BUGS 
If underlining is present it may be messed up by folding. 
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NAME 
from — who is my mail from? 

SYNOPSIS 
from { —s sender | [ user ] 

DESCRIPTION 
From prints out the mail header lines in your mailbox file to show you who your mail is from. 
If user is specified, then user's mailbox is examined instead of your own. If the -s option is 
given, then only headers for mail sent by sender are printed. 


FILES 
/usr/spool/matl/* 


SEE ALSO 
biff(1), mail(1), prmail() 
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NAME 


gets — get a string from standard input 


SYNOPSIS 


gets ( default ] 


DESCRIPTION 


N.B.: This command was introduced for use in ./ogin scripts when the facilities of the tser(1) 
command were not totally adequate in setting the terminal type. This is no longer true, and 
gets should no longer be needed. To boot, a construct ‘‘$<”’ is available in csh(1) now which 
has the functionality of gets: 

set a=$< 

if $a == ”’) set a=default 


replaces 
set a=‘gets default‘ 
Users of sh(1) should use its read command rather than gers. 


Gets can be used with csh(1) to read a string from the standard input. If a default is given it is 
used if just return is typed, or if an error occurs. The resultant string (either the default or as 
read from the standard input is written to the standard output. If no default is given and an 
error occurs, gets exits with exit status 1. 


SEE ALSO 


BUGS 


esh (1) 


Gets is obsolete. 
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NAME 

graph — draw a graph 
SYNOPSIS 

graph [ option ] ... 


DESCRIPTION 
Graph with no options takes pairs of numbers from the standard input as abscissas and ordi- 
nates of a graph. Successive points are connected by straight lines. The graph is encoded on 
the standard output for display by the p/or(1) filters. 


If the coordinates of a point are followed by a nonnumeric string, that string is printed as a 
label beginning on the point. Labels may be surrounded with quotes "...", in which case they 
may be empty or contain blanks and numbers; labels never contain newlines. 


The following options are recognized, each as a separate argument. 


— 3 Supply abscissas automatically (they are missing from the input); spacing is given by 
the next argument (default 1). A second optional argument is the starting point for 
automatic abscissas (default 0 or lower limit given by —x). 


—b Break (disconnect) the graph after each label in the input. 
== Character string given by next argument is default label for each point. 


Pp Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full grid (default). 


| Next argument is label for graph. 


—m Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected 
(default). Some devices give distinguishable line styles for other smail integers. 


—s§ Save screen, don’t erase before plotting. 


—x{1] 
If ] is present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x 
limits. Third argument, if present, is grid spacing on x axis. Normally these quantities 
are determined automatically. 


Similarly for y. 
—h Next argument is fraction of space for height. 
— W Similarly for width. 
—F Next argument is fraction of space to move right before plotting. 
— ul Similarly to move up before plotting. 
ane Transpose horizontal and vertical axes. (Option —x now applies to the vertical axis.) 
A legend indicating grid range is produced with a grid unless the —s option is present. 
If a specified lower limit exceeds the upper limit, the axis is reversed. 


SEE ALSO 
spline(1), plot(1) 
BUGS 
Graph stores all points internally and drops those for which there isn’t room. 
Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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grep, egrep, fgrep — search a file for a pattern 


SYNOPSIS 


grep { option ] ... expression [ file ] ... 
egrep [ option ] ... { expression ] [ file ] ... 
fgrep [ option] ... { strings ] [ file ] 


DESCRIPTION 


Commands of the grep family search the input files (standard input default) for lines matching a 
pattern. Normally, each line found is copied to the standard output. Grep patterns are limited 
regular expressions in the style of ex(1); it uses a compact nondeterministic algorithm. Egrep 
patterns are full regular expressions; it uses a fast deterministic algorithm that sometimes needs 
exponential space. fFgrep patterns are fixed strings; it is fast and compact. The following 
options are recognized. 


—y All lines but those matching are printed. 

—X (Exact) only lines matched in their entirety are printed (/grep only). 

ad Only a count of matching lines is printed. 

~| The names of files with matching lines are listed (once) separated by newlines. 
— nN Each line is preceded by its relative line number in the file. 


hb Each line is preceded by the block number on which it was found. This is sometimes 
useful in locating disk block numbers by context. 


i The case of letters is ignored in making comparisons. (E.g. upper and lower case are 
considered identical.) (grep and /grep only) 


—§ Silent mode. Nothing is printed (except error messages). This is useful for checking 
the error status. 


—w _ The expression is searched for as a word (as if surrounded by ‘\<’ and ‘\>’, see 
ex(1).) (grep only) 


—e expression 
Same as a simple expression argument, but useful when the expression begins with a —. 


—f file The regular expression (egrep) or string list (grep) is taken from the lle. 


In all cases the file name is shown if there is more than one input file. Care should be taken 
when using the characters $ * [*|() and \ in the expression as they are also meaningful to the 
Shell. It is safest to enclose the entire expression argument in single quotes °°. 


Fgrep searches for lines that contain one of the (newline-separated) srrings. 


Egrep accepts extended regular expressions. In the following description ‘character’ excludes 
newline: 


A \ followed by a single character other than newline matches that character. 

The character ~ ($) matches the beginning (end) of a line. 

A. matches any character. 

A single character not otherwise endowed with special meaning matches that character. 


A string enclosed in brackets [] matches any single character from the string. Ranges 
of ASCII character codes may be abbreviated as in ‘a-—z0—9°. A] may occur only as 
the first character of the string. A literal ~ must be placed where it can’t be mistaken 
as a range indicator. 
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A regular expression followed by * (+, 9) matches a sequence of 0 or more (1 or 
more, 0 or 1) matches of the regular expression. 


Two regular expressions concatenated match a match of the first followed by a match of 
the second. 


Two regular expressions separated by | or newline match either a match for the first or a 
match for the second. 


A regular expression enclosed in parentheses matches a match for the regular expres- 
sion, 


The order of precedence of operators at the same parenthesis level is [] then “+? then con- 
catenation then | and newline. 


SEE ALSO 
ex(1), sed(1), sh(1) 


DIAGNOSTICS 
Exit status is 0 if any matches are found, | if none, 2 for syntax errors or inaccessible files. 


BUGS 
Ideally there should be only one grep, but we don’t know a single algorithm that spans a wide 
enough range of space-time tradeoffs. 


Lines are limited to 256 characters; longer lines are truncated. 
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NAME 

head — give first few lines of a stream 
SYNOPSIS | 

head { —count ] [ file... ] 
DESCRIPTION 


This filter gives the first count lines of each of the specified files, or of the standard input. If 
count is omitted it defaults to 10. 


SEE ALSO 
tail(1) 
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NAME 


iostat — report I/O statistics 


SYNOPSIS 


iostat [ interval [ count ] ] 


DESCRIPTION . 


a 


FILES 


lostat iteratively reports the number of characters read and written to terminals, and, for each 
disk, the number of seeks and transfers per second, and the milliseconds per average seek. It 
also gives the percentage of time the system has spent in user mode, in user mode running low 
priority (niced) processes, in systern mode, and idling. 


To compute this information, for each disk, seeks and data transfer completions and number of 
words transferred are counted; for terminals collectively, the number of input and output char- 
acters are counted. Aliso, each sixtieth of a second, the state of each disk is examined and a 
tally is made if the disk is active. From these numbers and given the transfer rates of the dev- 
ices it is possible to determine average seek times for each device. 


The optional interval argument causes josrat to report once each interval seconds. The first 
report is for all time since a reboot and each subsequent report is for the last interval only. 


The optional count argument restricts the number of reports. 


/dev/kmem /vmunix 


SEE ALSO 


vmstat(1) 
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NAME 

join — relational database operator 
SYNOPSIS 

join [ options ] filel file2 


DESCRIPTION 


Join forms, on the standard output, a join of the two relations specified by the lines of file and 
 file2. If filel is ‘—’, the standard input is used. 


Filel and file2 must be sorted in increasing ASCII collating sequence on the fields on whice 
they are to be joined, normally the first in each line. 


There is one line in the output for each pair of lines in file/ and file2 that have dential: joia 


fields. The output line normally consists of the common field, then the rest of the line from 
_ filel, then the rest of the line from file2. 


. Fields are normally separated by blank, tab or newline. In this case, multiple separators count 
as one, and leading separators are discarded. 


These options are recognized: 


—an In addition to the normal output, produce a line for each unpairable line in file a, 
where vis 1 or 2. 


es Replace empty output fields by string s. 
“jn m Join on the mth field of file n. If nis missing, use the mth field in each file. 


- o list Each output line comprises the fields specifed in /ist, each element of which has the 
form a.m, where nis a file number and mis a field number. 


Lo, | —tc Use character c aS a separator (tab character). Every appearance of c in a line is 
a significant. 
SEE ALSO 
sort(1), comm(1), awk(1) 


BUGS 


With default field separation, the collating sequence is that of sort ~b; with —t, the sequence is 
“that of a plain sort. 


~ The conventions of join, sort, comm, unig, look and awk(1) are wildly incongruous. 
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NAME 
kill ~ terminate a process with extreme prejudice 


SYNOPSIS 
kill [ —sig ] processid ... 
kill —] 


DESCRIPTION 
Kill sends the TERM (terminate, 15) signal to the specified processes. If a signal name or 
number preceded by *~’ is given as first argument, that signal is sent instead of terminate (see 
signal(2)), The signal names are listed by ‘kill —I’, and are as given in /usr/include/signal.h, 
stripped of the common SIG prefix. 


The terminate signal will kill processes that do not catch the signal; ‘kill —9...’ is a sure kill, as 
the KILL (9) signal cannot be caught. By convention, if process number 0 is specified, all 
members in the process group (i.e. processes resulting from the current login) are signaled (but 
beware: this works only if you use sf(1); not if you use cs#(1).) The killed processes must 
belong to the current user unless he is the super-user. 


To shut the system down and bring it up single user the super-user may send the initialization 
process a TERM (terminate) signal by ‘kill 1’; see iniz(8). To force init to close and open ter- 
minals according to what is currently in /etc/ttys use ‘kill ~HUP 1’ (sending a hangup, signal 
Li): 


The process number of an asynchronous process started with ‘&’ is reported by the shell. Pro- 


cess numbers can also be found by using Kil! is a built-in to csh(1); it allows job specifiers 
‘0% _..”* so process id’s are not as often used as kil/ arguments. See csh(1) for details. 


SEE ALSO 
esh(1), ps(1), kill(2), signal(2) 

BUGS 
An option to kill process groups ala killpg(2) should be provided; a replacement for “‘kill 0”’ for 
csh(1) users should be provided. 
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NAME 


last — indicate last logins of users and teletypes 


SYNOPSIS 


last [name... ] [tty ... ] 


DESCRIPTION 


FILES 


Last will look back in the wrmp file which records all logins and logouts for information about a 
user, a teletype or any group of users and teletypes. Arguments specify names of users or tele- 
types of interest. Names of teletypes may be given fully or abbreviated. For example ‘last 0° is 
the same as ‘last ttyO’. If multiple arguments are given, the information which applies to any 
of the arguments is printed. For example ‘last root console’ would list all of "root’s” sessions as 
well as all sessions on the console terminal. Lasr will print the sessions of the specified users 
and teletypes, most recent first, indicating the times at which the session began, the duration of 
the session, and the teletype which the session took place on. If the session is still continuing 
or was cut short by a reboot, /astso indicates. | 


The pseudo-user reboot logs in at reboots of the system, thus 
last reboot 
will give an indication of mean time between reboot. 
Last with no arguments prints a record of all logins and logouts, in reverse order. 


If Jast is interrupted, it indicates how far the search has progressed in wemp. If interrupted with 
a quit signal (generated by a control-\) Jast indicates how far the search has progressed so far, 
and the search continues. 


/usr/adm/wtmp login data base 
/usr/adm/shutdownlog which records shutdowns and reasons for same 


SEE ALSO > 


wimp(5), ac(8), lastcomm(1) 


AUTHOR 


Howard Katsef® 
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NAME 

lastcomm - show last commands executed in reverse order 
SYNOPSIS 

lastcomm [ command name } ... [user name] ... 
DESCRIPTION 


Lastcomm gives information on previously executed commands. Lasicomm with no arguments 
prints information about all the commands recorded during the current accounting file’s life- 
time. If called with arguments, only those accounting entries whose command name or user 
name matches one of the arguments are printed. So, for example, 

lasteorumn a.out 
would produce a listing of all the executions of commands named a.out, and 

lastcomm root 
would produce a listing of all the commands executed by user root. 


For each process entry, the following are printed. 
The name of the user who ran the process. 
The command name under which the process was called. 
The amount of cpu time used by the process (in seconds). 
The time the process exited. 


AUTHOR 
Len Edmondson 


SEE ALSO 
last (1) 
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ld — link editor 


SYNOPSIS 


Id [ option ] ... file .. 


DESCRIPTION 


Ld combines several object programs into one, resolves external references, and searches 
libraries. In the simplest case several object files are given, and /d combines them, producing an 
object module which can be either executed or become the input for a further /d run. (In the 
latter case, the —r option must be given to preserve the relocation bits.) The output of /d is 
left on a.out. This file is made executable only if no errors occurred during the load. 


The argument routines are concatenated in the order specified. The entry point of the output is 
the beginning of the first routine (unless the —e option is specified). 


If any argument is a library, it is searched exactly once at the point it is encountered in the 
argument list. Only those routines defining an unresolved external reference are loaded. If a 
routine from a library references another routine in the library, and the library has not been 
processed by ranlib(1), the referenced routine must appear after the referencing routine in the 
library. Thus the order of programs within libraries may be important. The first member of a 
library should be a file named ‘_ .SYMDEF’, which is understood to be a dictionary for the 
library as produced by ranlib(1); the dictionary is searched iteratively to satisfy as many refer- 
ences as possible. 


The symbols *_etext’, ‘_edata’ and ‘_ end’ (‘etext’, ‘edata’ and ‘end’ in C) are reserved, and if 
referred to, are set to the first location above the program, the first location above initialized 
data, and the first location above all data respectively. It is erroneous to define these symbols. 


Ld understands several options. Except for —l, they should appear before the file names. 


—A This option specifies incremental loading, i.e. linking is to be done in a manner So that 
the resulting object may be read into an already executing program. The next argument 
is the name of a file whose symbol table will be taken as a basis on which to define 
additional symbols. Only newly linked material will be entered into the text and data 
portions of a.out, but the new symbol table will reflect every symbol defined before and 
after the incremental load. This argument must appear before any other object file in 
the argument list. The —T option may be used as well, and will be taken to mean that 
the newly linked segment will commence at the corresponding address (which must be 
a multiple of 1024). The default value is the old value of _end. 


—-D Take the next argument as a hexadecimal number and pad the data segment with zero 
bytes to the indicated length. 


—d Force definition of common storage even if the —r flag is present. 


—e The following argument is taken to be the name of the entry point of the loaded pro- 
gram, location 0 is the default. 


—lx This option is an abbreviation for the library name ‘/lib/libx.a’, where x is a string. If 
that does not exist, /d tries ‘/usr/lib/libx.a’ A library is searched when its name is 
encountered, so the placement of a —] is significant. 


—M produce a primitive load map, listing the names of the files which will be loaded. 
—N Do not make the text portion read only or sharable. (Use “magic number” 0407.) 


—n Arrange (by giving the output file a 0410 “magic number") that when the output file is 
executed, the text portion will be read-only and shared among all users executing the 
file. This involves moving the data areas up to the first possible 1024 byte boundary 
following the end of the text. 
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0 The name argument after ~o is used as the name of the /d output file, instead of a.out. 


aad 9 Generate relocation bits in the output file so that it can be the subject of another /d run. 
This flag also prevents final definitions from being given to common symbols, and 
suppresses the ‘undefined symbol’ diagnostics. 


=S ‘Strip’ the output by removing all symbols except locals and globals. 

—S ‘Strip’ the output, that is, remove the symbol table and relocation bits to save space 
(but impair the usefulness of the debuggers). This information can also be removed by 
strip(1). 


sail The next argument is a hexadectmal number which sets the text segment origin. The 
default origin is 0. 


—t ("trace") Print the name of each file as it is processed. 


=O Take the following argument as a symbol and enter it as undefined in the symbol table. 
This is useful for loading wholly from a library, since initially the symbol table is-empty 
and an unresolved reference is needed to force the loading of the first routine. 


—X Save local symbols except for those whose names begin with ‘L’. This option is used 
by cc(1) to discard internally-generated labels while retaining symbols local to routines. 


—X Do not preserve local (non-.globi) symbols in the output symbol table; only enter 
external symbols. This option saves some space in the output file. 


—ysym Indicate each fle in which sym appears, its type and whether the file defines or refer- 
ences it. Many such options may be given to trace many symbols. (It is usually neces- 
sary to begin sym with an ‘_*, as external C, FORTRAN and Pascal variables begin with 
underscores.) 


— 7 Arrange for the process to be loaded on demand from the resulting executable file (413 
format) rather than preloaded. This is the default. Results in a 1024 byte header on 
the output file followed by a text and data segment each of which have size a multiple 
of 1024 bytes (being padded out with nulls in the file if necessary). With this format 
the first few BSS segment symbols may actually appear (from the output of size(2)) to 
live in the data segment, this to avoid wasting the space resulting from data segment 
size roundup. 


FILES 
/Nib/lib=.a libraries 
/usr/lib/lib«.a more libraries 
fusr/local/lib/lib«.a still more libraries 
a.out output file 

SEE ALSO 


as(1), ar(1), ec(1), ranlib(1) 


. BUGS 
There is no way to force data to be page aligned. 
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NAME 
learn — computer aided instruction about UNIX 
SYNOPSIS 
learn [ —directory ] [ subject [ lesson [ speed ] ] ] 
DESCRIPTION 
Learn gives CAI courses and practice in the use of UNIX. To get started simply type ‘learn’. 
The program will ask questions to find out what you want to do. The questions may be 
bypassed by naming a sudject, and the last /esson number that /earn told you in the previous ses- 
sion. You may also include a speed number that was given with the lesson number (but 
without the parentheses that /earn places around the speed number). If /esson is ‘—’, learn 
prompts for each lesson; this is useful for debugging. 
The subjects presently handled are 
editor 
eqn 
files 
macros 
morefiles 
C 
The special command ‘bye’ terminates a /earn session. 
The — directory option allows one to exercise a Script in a nonstandard place. 
FILES 
/usr/\earn and all dependent directories and files 
BUGS 


The main strength of learn, that it asks the student to use the real UNIX, also makes possible 
baffling mistakes. It is helpful, especially for nonprogrammers, to have a UNIX initiate near at 
hand during the first sessions. 


Occasionally lessons are incorrect, sometimes because the local version of a command operates 
in a non-standard way. Such lessons may be skipped, but it takes some sophistication to recog- 
nize the situation. 
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NAME 
leave — remind you when you have to leave 


SYNOPSIS 
leave [ hhmm |} 

DESCRIPTION 
Leave waits until the specified time, then reminds you that you have to leave. You are rem- 
inded 5 minutes and 1 minute before the actual time, at the time, and every minute thereafter. 
When you log off, /eave exits just before it would have printed the next message. 


The time of day is in the form hhmm where hh is a time in hours (on a 12 or 24 hour clock). 
Ali times are converted to a 12 hour clock, and assumed to be in the next 12 hours. 


If no argument is given, /eave prompts with "When do you have to leave?". A reply of newline 
causes leave to exit, otherwise the reply is assumed to be a time. This form is suitable for 
inclusion in a .login or .pro/ile. 


Leave ignores interrupts, quits, and terminates. To get rid of it you should either log off or use 
*“kill -9°” giving its process id. 

SEE ALSO 
calendar (1) 


AUTHOR 
Mark Horton 


BUGS 
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NAME 

lex — generator of lexical analysis programs 
SYNOPSIS 

lex { —tvfn } { file] ... 
DESCRIPTION 


Lex generates programs to be used in simple lexical analyis of text. The input files (standard 


input default) contain regular expressions to be searched for, and actions written in C to be 
executed when expressions are found. 


A C source program, ‘lex.yy.c’ is generated, to be compiled thus: 
ce lex.yy.c —ll 


This program, when run, copies unrecognized portions of the input to the output, and executes 
the associated C action for each regular expression that is recognized. 


The following /ex program converts upper case to lower, removes blanks at the end of lines, 
and replaces multiple blanks by single blanks. 


%% 

[A—Z] putchar(yytext[0] +’a’—’A’); 
[]+8 

{]+  putchar(’ ’); 


The options have the following meanings. 

—t¢ Place the result on the standard output instead of in file ‘lex.yy.c’. 
= y Print a one-line summary of statistics of the generated analyzer. 
—n Opposite of —y; —n is default. 


={ ‘Faster’ compilation: don’t bother to pack the resulting tables; limited to small pro- 
grams. 
SEE ALSO 
yace(1) 
M. E. Lesk and E. Schmidt, LEX — Lexical Analyzer Generator 
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NAME 
lint — a C program verifier 


SYNOPSIS 
| lint [ —abchnpuvx J file ... 


DESCRIPTION 

Lint attempts to detect features of the C program files which are likely to be bugs, or non- 
portable, or wasteful. It also checks the type usage of the program more strictly than the com- 
pilers. Among the things which are currently found are unreachable statements, loops not 
entered at the top, automatic variables declared and not used, and logical expressions whose 
value is constant. Moreover, the usage of functions is checked to find functions which return 
values in some places and not in others, functions called with varying numbers of arguments, 
and functions whose values are not used. 


By default, it is assumed that all the files are to be loaded together; they are checked for mutual 
compatibility. Function definitions for certain libraries are available to J/inr, these libraries are 
referred to by a conventional name, such as ‘Im’, in the style of /d(1). 


Any number of the options in the following list may be used. The —D, ~U, and —I options of 
ce(1) are also recognized as separate arguments. 


p Attempt to check portability to the /BM and GCOS dialects of C. 

h Apply a number of heuristic tests to attempt to intuit bugs, improve style, and reduce 
waste. 

b Report break statements that cannot be reached. (This is not the default because, 
unfortunately, most /ex and many yacc outputs produce dozens of such comments.) 

v Suppress complaints about unused arguments in functions. 

x Report variables referred to by extern declarations, but never used. 

a Report assignments of long values to int variables. 

¢ Complain about casts which have questionable portability. 

u Do not complain about functions and variables used and not defined, or defined and 
not used (this is suitable for running /inton a subset of files out of a larger program). 

n Do not check compatibility against the standard library. 


Exit(2) and other functions which do not return are not understood, this causes various lies. 
Certain conventional comments in the C source will change the behavior of Jint: 


/*NOTREACHED=/ 
at appropriate points stops comments about unreachable code. 

/eVARARGSi«/ 
suppresses the usual checking for variable numbers of arguments in the following func- 
tion declaration. The data types of the first a arguments are checked, a missing 7 1s 
taken to be 0. 

/*NOSTRICT«/ 
shuts off strict type checking in the next expression. 

/*ARGSUSED=s/ 
turns on the ~v option for the next function. 


/eLINTLIBRARY=#/ 
at the beginning of a file shuts off complaints about unused functions in this file. 
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FILES 
/usr/lib/lint/lint{12] programs 
/usr/lib/lint/lib-lc declarations for standard functions 
/usr/lib/lint/llib-port declarations for portable functions 
SEE ALSO 
ce(]) 
S. C. Johnson, Lint, a C Program Checker 


BUGS 


There are some things you just can’t get lint to shut up about. 
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NAME 


lisp — lisp interpreter 


SYNOPSIS 


lisp 


DESCRIPTION 


Lisp is a lisp interpreter for a dialect which closely resembles MIT’s MACLISP. This lisp, known 
as FRANZ LIsP, features an I/O facility which allows the user to change the input and output 
syntax, add macro characters, and maintain compatibility with upper-case only lisp systems; 
infinite precision integer arithmetic, and an error facility which allows the user to trap system 
errors in many different ways. Interpreted functions may be mixed with code compiled by 
lisze(1) and both may be debugged using the ‘‘Joseph Lister’’ trace package. A /isp containing 
compiled and interpreted code may be dumped into a file for later use. | 


There are too many functions to list here; one should refer to the manuals listed below. 


AUTHORS 


An early version was written by Jeff Levinsky, Mike Curry, and John Breedlove. Keith 
Sklower wrote and is maintaining the current version, with the assistance of John Foderaro. 
The garbage collector was implemented by Bill Rowan. 


FILES 
/ust/lib/lisp/auxfns0.! common functions 
/usr/lib/lisp/auxfns1.} less common functions 
fusr/lib/lisp/trace.] Joseph Lister trace package 
SEE ALSO 
liszt(1) 


BUGS 


‘FRANZ Lisp Manual, Version 1’ by John K. Foderaro 
MACLISP Manual 


The error system is in a state of flux and not all error messages are as informative as they could 
be. 
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NAME 

liszt — compile a Franz Lisp program 
SYNOPSIS 

liszt | —mpqruwxCQST ] [ —o objfile] [ name ] 
DESCRIPTION 


Liszt takes a file whose names ends in ‘.1’ and compiles the FRANZ LISP code there leaving an 
object program on the file whose name is that of the source with ‘.o” substituted for *.!". 


The following options are interpreted by /Jiszz. 


-—m Compile a MACLISP file, by changing the readtable to conform to MACLISP syntax and 
including a macro-defined compatibility package. 


—0 Put the object code in the specified file, rather than the default ‘.o’ file. 


—p places profiling code at the beginning of each non-local function. If the lisp system is 


also created with profiling in it, this allows function calling frequency to be determined 
(see profil).) 


~q Only print warning and error messages. Compilation Statistics and notes on correct but 
unusual constructs will not be printed. 


—f place bootstrap code at the beginning of the object file, which when the object file is 
executed will cause a lisp system to be invoked and the object file fas!ed in. 


—u Compile a UCl-lispfile, by changing the readtable to conform to UCI-Lisp syntax and 
including a macro-defined compatibility package. 


—w Suppress warning diagnostics. 


— X Create a lisp cross reference file with the same name as the source file but with ‘.x’ 


appended. The program Ixref(l1) reads this file and creates a human readable cross 
reference listing. 


—-C put comments in the assembler output of the compiler. Useful for debugging the com- 
piler. 


-Q Print compilation statistics and warn of strange constructs. This is the default. 


-§ Compile the named program and leave the assembler-language output on the 
corresponding file suffixed ‘.s’. This will also prevent the assembler language file from 
being assembled. 


-T send the assembler output to standard output. 


If no source file is specified, then the compiler will run interactively. You will find yourself 
talking to the Jisp(1) top-level command interpreter. You can compile a file by using the func- 
tion liszt (an nlambda) with the same arguments as you use on the command line. For example 
to compile ‘foo’, a MACLISP file, you would use: 


(liszt —m foo) 
Note that Jiszt supplies the ‘*.1’’ extension for you. 


FILES 
/usr/\ib/lisp/machacks.1 MACLISP compatibility package 
/usr/lib/lisp/syscall.] macro definitions of Unix system calls 
fusr/lib/lisp/ucifne.) UCI Lisp compatibility package 
AUTHOR 


John Foderaro 
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SEE ALSO 
lisp(1), Ixref(1) 
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NAME 
In — make links 


SYNOPSIS 
In namel [ name2 |] 
In name ... directory 


DESCRIPTION 

A link is a directory entry referring to a file; the same file (together with its size, all its protec- 
tion information, etc.) may have several links to it. There is no way to distinguish a link to a 
file from its original directory entry; any changes in the file are effective independently of the 
name by which the file is known. | 
Given one or two arguments, /n creates a link to an existing file name/. If namie? is given, the 
link has that name; name2 may also be a directory in which to place the link; otherwise it 1s 
placed in the current directory. If only the directory is specified, the link will be made with its 
name the same as the last component of name!. 


Given more than two arguments, /n makes links to all the named files in the named directory. 
The links made will have the same name as the files being linked to. 


It is forbidden to link to a directory or to link across file systems. 


SEE ALSO 
rm(1), cp(1), mv(1) 


rtm 
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NAME 
lock - reserve a terminal 


SYNOPSIS. 
lock 


DESCRIPTION 
Lock requests a password from the user, then prints "LOCKED" on the terminal and refuses to 
relinquish the terminal until the password is repeated. If the user forgets the password, he has 
no other recourse but to login elsewhere and kill the lock process. 

AUTHOR 
Kurt Shoens 

BUGS 
Should timeout after 15 minutes. 
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NAME 


login — sign on 


SYNOPSIS 


login [ username ] 


DESCRIPTION 


FILES 


The login command is used when a user initially signs on, or it may be used at any time to 
change from one user to another. The latter case is the one summarized above and described 
here. See ‘‘How to Get Started”’ for how to dial up initially. 


If login is invoked without an argument, it asks for a user name, and, if appropriate, a pass- 
word. Echoing is turned off (if possible) during the typing of the password, so it will not 
appear on the written record of the session. 


After a successful login, accounting files are updated and the user is informed of the existence 
of mail, and the message of the day is printed, as is the time he last logged in (unless he has a 


‘* hushlogin”’ file in his home directory — this is mostly used to make life easier for non- 
human users, such as uucp). 


Login initializes the user and group IDs and the working directory, then executes a command 
interpreter (usually sh(1)) according to specifications found in a password file. Argument 0 of. 
the command interpreter is ‘‘-sh’’, or more generally the name of the command interpreter 
with a leading dash (‘‘—*’) prepended. 


Login also initializes the environment environ(5) with information specifying home directory, 
command interpreter, terminal type (if available) and user name. 


If the file /etc/nologin exists /ogin prints its contents on the user’s terminal and exits. This is 
used by shutdown(8) to stop users logging in when the system is about to go down. 


Login is recognized by sh(1) and csh(1) and executed directly (without forking). 


/etc/utmp accounting 
/usr/adm/wtmp accounting 
/usr/spool/mail/* mail 


/etc/motd message-of-the-day 

/etc/ passwd password file 

/etc/nologin stops logins 

-hushlogin makes login quieter 

/etc/securetty lists ttys that root may log in on 
SEE ALSO 


init(8), newgrp(1), getty(8), mail(1), passwd(1), passwd(5), environ(5), shutdown (8) 


DIAGNOSTICS 


‘‘Login incorrect,”” if the name or the password is bad. 
‘*No Shell’’, ‘‘cannot open password file’’, ‘‘no directory’’: consult a programming counselor. 
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NAME 
lorder — find ordering relation for an object library 
SYNOPSIS 
lorder file ... 
DESCRIPTION 
The input is one or more object or library archive (see ar(1)) files. The standard output is a list 
of pairs of object file names, meaning that the first file of the pair refers to external identifiers 


defined in the second. The output may be processed by tsorr(1) to find an ordering of a library 
suitable for one-pass access by /d(1). 


This brash one-liner intends to build a new library from existing ‘.o’ files. 
ar cr library ‘lorder *.o | tsort’ 


The need for lorder may be vitiated by use of ranlib(1), which converts an ordered archive into 
a randomly accessed library. 
FILES | 
*symref, *symdef 
nm(1), sed(1), sort(1), join(1) 
SEE ALSO 
tsort(1), Id(1), ar(1), ranlib()) 
BUGS 


The names of object files, in and out of libraries, must end with ‘.o’; nonsense results other- 
wise. 
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NAME 
lpr, Iprm, Ipq, print — line printer spooler 


SYNOPSIS 
ipr { —m] (name... ] 
iprm (id... } [ filename... }] [ owner... ] 
ipq 
print file .., 
DESCRIPTION 
Lpr causes the named files to be queued for printing. If no files are named, the standard input 
is read. The option —m causes notification via mail(1} to be sent when the job completes. 


Lprm removes an entry from the line printer queue. The id, filename or owner should be that 
reported by (pg. All appropriate files will be removed. The id of each file removed from the 
queue will be printed. 


Lpg prints the line printer queue. Each entry in the queue is printed showing the owner of the 
queue entry, an identification number, the size of the entry in characters, and the file which is 
to be printed. The id is useful for removing a specific entry from the printer queue using 


Iprm()). 
Print pr’sa copy of each named file on the line printer. It is a one line shell script: 
pr $e | lpr 
FILES 
/usr/spool/ipd/* spool area 
/usr/lib/ipd printer daemon 
/usr/lib/ipf filter to handle banners and underlining 
SEE ALSO 
pr(1) 
BUGS 
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NAME 
Is — list contents of directory 


SYNOPSIS 


Is [ ~abedfgilmarstux1CFR ] name ... 
1 { ls options } name ... 


DESCRIPTION 


For each directory argument, /s lists the contents of the directory; for each file argument, /s 
repeats its name and any other information requested. The output is sorted alphabetically by 
default. When no argument is given, the current directory is listed. When several arguments 


are given, the arguments are first sorted appropriately, but file arguments appear before direc- 
tories and their contents. 


There are three major listing formats. The format chosen depends on whether the output is 
going to a teletype, and may also be controlled by option flags. The default format for a tele- 
type is to list the contents of directories in multi-column format, with the entries sorted down 
the columns. (Files which are not the contents of a directory being interpreted are always 
sorted across the page rather than down the page in columns. This is because the individual file 
names may be arbitrarily long.) If the standard output is not a teletype, the default format is to 
list one entry per line. Finally, there is a stream output format in which files are listed across 


the page, separated by ‘,’ characters. The —m flag enables this format; when invoked as / this 
format is also used. 


There are an unbelievable number of options: 


—| List in long format, giving mode, number of links, owner, size in bytes, and time of 
last modification for each file. (See below.) If the file is a special file the size field will 
instead contain the major and minor device numbers. 


—t Sort by time modified (latest first) instead of by name, as is normal. 
—2 List all entries; usually ‘*.’ and ‘..’ are suppressed. 
—=s§ Give size in blocks, including indirect blocks, for each entry. 


—d If argument is a directory, list only its name, not its contents (mostly used with —1 to 
get status on directory). 


=F Reverse the order of sort to get reverse alphabetic or oldest first as appropriate. 

—~wu Use time of last access instead of last modification for sorting (~t) or printing (—]). 
=¢ Use time of file creation for sorting or printing. 

—i Print i-number in first column of the report for each file listed. 

— f Force each argument to be interpreted as a directory and list the name found in each 


slot. This option turns off —l, —t, —s, and —r, and turns on —a; the order is the 
order in which entries appear in the directory. 


—¢ Give group ID instead of owner ID in long listing. 

—m _ force stream output format 

=] force one entry per line output format, e.g. to a teletype 
—C force multi-column output, e.g. to a file or a pipe 


—g force printing of non-graphic characters in file names as the character *?’; this normally 
happens only if the output device is a teletype 


—b force printing of non-graphic characters to be in the \ddd notation, in octal. 


aX force columnar printing to be sorted across rather than down the page; this is the 
default if the last character of the name the program is invoked with is an ‘x’. 
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-F cause directories to be marked with a trailing ‘/° and executable files to be marked with 
a trailing “*’; this is the default if the last character of the name the program is invoked 
with isa ‘f’. 

—-R recursively list subdirectories encountered. 


The mode printed under the ~I option contains 11 characters which are interpreted as follows: 
the first character is 


if the entry is a directory; 

if the entry is a block-type special file; 

if the entry is a character-type special file: 

if the entry is a multiplexor-type character special file; 
if the entry ts a plain file. 


,pg cS & 


The next 9 characters are interpreted as three sets of three bits each. The first set refers to 
owner permissions; the next to permissions to others in the same user-group; and the last to all 
others. Within each set the three characters indicate permission respectively to read, to write, 
or to execute the file as a program. For a directory, ‘execute’ permission is interpreted to mean 
permission to search the directory for a specified file. The permissions are indicated as follows: 


if the file is readable; 

if the file is writable: 

if the file is executable, 

if the indicated permission is not granted. 


jxar 


The group-execute permission character is given as s if the file has set-group-ID mode; likewise 
the user-execule permission character is given as s if the file has set-user-ID mode. 


The last character of the mode (normally ‘x’ or ‘—’) is t if the 1000 bit of the mode is on. See 
chmod(1) for the meaning of this mode. 


When the sizes of the files in a directory are listed, a total count of blocks, including indirect 
blocks is printed. 


/etc/passwd to get user [D’s for ‘is —I’. 
/etc/group to get group [D's for ‘Is —g’. 


Newline and tab are considered printing characters tn file names. 
The output device is assumed to be 80 columns wide. 


The option setting based on whether the output is a teletype is undesirable as ‘‘Is —s’’ is much 
different than “‘Ils —sjlpr’’. On the other hand, not doing this setting would make old shell 
scripts which used /s almost certain losers. 


Column widths choices are poor for terminals which can tab. 
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NAME 
Ixref — lisp cross reference program 


SYNOPSIS 
Ixref [ —N ] file ... 


DESCRIPTION 
Lxref reads cross reference file(s) written by the lisp compiler /iszt and prints a cross reference 
listing on the standard output. Liszt will create a cross reference file during compilation when it . 
is given the —x switch. Cross reference files usually end in ‘.x’ and consequently xref will 
append a ‘.x’ to the file names given if necessary. The one option to Lrrefis a decimal integer, 
N, which sets the ignorelevel. If a function is called more than ignorelevel times, the cross refer- 
ence listing will just print the number of calls instead of listing each one of them. The default 
for ignorelevel is 50. 


AUTHOR 
John Foderaro 


SEE ALSO 
lisp(1), liszt(1) 


BUGS 
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m4 — macro processor 


SYNOPSIS 


4 { files | 


DESCRIPTION 


M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each — 
the argument files is process sec in order; if there are no arguments, or if an argument is ‘ 
the standard input is read. The processed text is written on the standard output. 


is r 
Macro calls have the form 
name(argi,arg2,... , argn) 


The ‘(’ must sa aica dee follow the name of the macro. If a defined macro name is not fol- 
lowed by a ‘(’, it is deemed to have no arguments. Leading unquoted blanks, tabs, and new- 
lines are ignored while collecting arguments. Potential macro names consist of alphabetic 
letters, digits, and underscore ‘ ', where the first character is not a digit. 


Left and right single quotes ( " are used to quote strings. The value of a quoted string is the 
string stripped of the quotes. 


When a macro name .* :scognized, its arguments are collected by searching for a matching right 
parenthesis. Macro evaluation proceeds normally during the collection of the arguments, and 
any commas or right parentheses which happen to turn up within the value of a nested call are 
as effective as those in the original input text. After argument collection, the value of the 
macro is pushed back onto the input stream and rescanned. 


M4 makes available the follow ing built-in macros. They may be redefined, but once this is 
done the original meaning is lost. Their values are null unless otherwise stated. 


define The second argument is installed as the value of the macro whose name is the first 
argument. Each occurrence of Sv in the replacement text, where n is a digit, is 
replaced by the a-th argument. Argument 0 is the name of the macro; missing 
arguments are replaced by the null string. 


undefine removes the definition of the macro named in its argument. 
ifdef If the first argument is defined, the value is the second argument, otherwise the 


third. If there is no third argurnent, the value is null. The word unix is predefined 
on UNIX versions of m4. 


changequote 
Change quote characters to the first and second arguments. Changequote without 
arguments restores the original values (i.e., °*). 


divert M4 maintains 10 output strearns, numbered 0-9. The final output is the concatena- 
tion of the streams in numerical order; initially stream 0 is the current stream. The 
divert macro changes the current output stream to its (digit-string) argument. Out- 
put diverted to a stream other than 0 through 9 is discarded. 


undivert causes immediate output of text from diversions named as arguments, or all diver- 
sions if no argument. Text may be undiverted into another diversion. Undiverting 
discards the diverted text. 


divnum = returns the value of the current output stream. | 
dni reads and discards characters up to and including the next newline. 


ifelse has three or more argurnents. If the first argument is the same string as the second, 


then the value is the third argument. [f not, and if there are more than four argu- 
ments, the process is repeated with arguments 4, 4, 6 and 7. Otherwise, the value is 
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incr 


eval 


len 
index 


substr 


translit 


include 
sinclude 
syscmd 
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either the fourth string, or, if it is not present, null. 


returns the value of its argument incremented by 1. The value of the argument is 
calculated by interpreting an initial digit-string as a decimal number. 


evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Opera- 
tors include +, —, *, /, %, ~ (exponentiation); relationals; parentheses. 


returns the number of characters in its argument. 


returns the position in its first argument where the second argument begins (zero 
origin), or —1 if the second argument does not occur. 


returns a substring of its first argument. The second argument is a zero origin 
number selecting the first character; the third argument indicates the length of the 
substring. A missing third argument is taken to be large enough to extend to the 
end of the first string. 


transliterates the characters in its first argument from the set given by the second 
argument to the set given by the third. No abbreviations are permitted. 


returns the contents of the file named in the argument. 
is identical to include, except that it says nothing if the file is inaccessible. 
executes the UNIX command given in the first argument. No value is returned. 


maketemp fills in a string of XXX XX in its argument with the current process id. 


errprint 


SEE ALSO 


prints its argument on the diagnostic output file. 


dumpdef prints current names and definitions, for the named items, or for all if no arguments 


are given. 


B. W. Kernighan and D. M. Ritchie, The M44 Macro Processor 
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NAME 
mail ~ send and receive mai! 


SYNOPSIS 
mail [—f [name]][ people... ] 


INTRODUCTION | 
Mail is a intelligent mail processing system, which has a command syntax reminiscent of ed 
with lines replaced by messages. 


Sending mail. To send a message to one or more other people, mail can be invoked with argu- 
ments which are the names of people to send to. You are then expected to type in your mes- 
sage, followed by an EOT (control—D) at the beginning of a line. The section below, labeled 
Replying to or originating mail, describes some features of mail available to help you compose 
your letier. 


Reading mail. In normal usage, mail is given no arguments and checks your mail out of the 
post office, then printing out a one line header of each message there. The current message is 
Initially the first message (numbered 1) and can be printed using the print command (which 
can be abbreviated p). You can move among the messages much as you move between lines in 
ed, with the commands *+° and ‘~’ moving backwards and forwards, and simple numbers typ- 
ing the addressed message. 


Disposing of mail. After examining a message you can delete (d) the message or reply (r) to it. 
Deletion causes the nail program to forget about the message. This is not irreversible, the 
message can be undeleted (u) by giving its number, or the mail session can be aborted by giv- 
ing the exit (x) command. Deleted messages will, however, usually disappear never to be seen 
again, 

Specifiing messages. Commands such as print and delete often can be given a list of message 
numbers as argument to apply to a number of messages al once. Thus ‘‘delete 1 2°" deletes 
messages | and 2, while ‘“‘delete 1—5S’’ deletes messages | through 5. The special name ‘‘="’ 
addresses all messages, and **S”’ addresses the last message; thus the command top which prints 
the first few lines of a message could be used in ‘“‘top *”’ to print the first few lines of ail mes- 
sages. 


Replying to or originating mail. You can use the reply command to Set up a response to a mes- 
Sage, sending it back to the person who it was from. Text you then type in, up to an end-of-file 
(or a line consisting only of a ‘‘*.’’) defines the contents of the message. While you are com- 
posing a message, ail treats lines beginning with the character ‘~’ specially. For instance, typ- 
ing ‘“"m’”’ (alone on a line) will place a copy of the current message into the response right 
shifting it by a tabstop. Other escapes will set up subject fields, add and delete recipients to the 
message and allow you to escape to an editor to revise the message or to a shell to run some 
commands. (These options will be given in the summary below.) 


Ending a mail processing session. You can end a mail session with the quit (q) command. Mes- 
sages which have been examined go to your sbax file unless they have been deleted in which 
case they are discarded. Unexamined messages go back to the post office. The ~f option 
causes sail to read in the contents of your box (or the specified file) for processing; when you 
quit mail writes undeleted messages back to this file. 


Personal and systemwide distribution lists. \t is also possible to create a personal distribution lists 
so that, for instance, you can send mail to ‘“‘cohorts’’ and have it go to a group of people. Such 
lists can be defined by placing a line like 


alias cohorts bill ozalp sklower jkf mark cory:kridle 
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rs 


in the file .mailrc in your home directory. The current list of such aliases can be displayed by 
the alias (a) command in mail. System wide distribution lists can be created by editing 
/usr/lib/aliases, see aliases(S) and delivermail(8), these are kept in a slightly different syntax. 
In mail you send, personal aliases will be expanded in mail sent to others so that they will be 
able to reply to the recipients. System wide aliases are not expanded when the mail is sent, but 
any reply returned to the machine will have the system wide alias expanded as all mail goes 
through delivermail. If you edit /usr/lib/aliases, you must run the program newaliases(1). 


Network mail (ARPA, UUCP, Berknet) Mail to sites on the ARPA network and sites within Bel! 
laboratories can be sent using ‘“name@site’’ for ARPA-net sites or ‘‘machine!user’’ for Bell 
labs sites, provided appropriate gateways are known to the system. (Be sure to escape the ! in 
Bell sites when giving it on a csh command line by preceding it with an \. Machines on an 
instance of the Berkeley network are addressed as ‘‘machine:user’’, e.g. ‘“‘csvax:bill’’. When 
addressed from the arpa-net, ‘“‘csvax:bill’’ is known as ‘‘csvax.bill@ berkeley’. 


Mail has a number of options which can be set in the .mailrc file to alter its behavior; thus ‘‘set 
askcc’’ enables the ‘‘askcc’’ feature. (These options are summarized below.) 
SUMMARY 
(Adapted from the ‘Mail Reference Manual’) Each command is typed on a line by itself, and 
may take arguments following the command word. The command need not be typed in its 
entirety — the first command which matches the typed prefix is used. For the commands 
which take message lists as arguments, if no message list is given, then the next message for- 
ward which satisfies the command’s requirements is used. If there are no messages forward of 
the current message, the search proceeds backwards, and if there are no good messages at all, 
Se mail types ‘“‘No applicable messages’” and aborts the command. 


= Goes to the previous message and prints it out. If given a numeric argument 7, 
goes to the n th previous message and prints it. 


Prints a brief summary of commands. 
: Executes the UNIX shell command which follows. 


alias (a) With no arguments, prints out all currently-defined aliases. With one argu- 
ment, prints out that alias. With more than one argument, adds the users named 
in the second and later arguments to the alias named in the first argument. 


chdir (c) Changes the user’s working directory to that specified, if given. If no direc- 
tory is given, then changes to the user’s login directory. 


delete (d) Takes a list of messages as argument and marks them all as deleted. Deleted 
messages will not be saved in mbox , nor will they be available for most other 
commands. | 

dp (also dt) Deletes the current message and prints the next message. If there ts no 
next message, sail says ‘‘at EOF.”’ 

edit (e) Takes a list of messages and points the text editor at each one in turn. On 
return from the editor, the message ts read back in. | 

exit (ex or x) Effects an immediate return to the Shell without modifying the user's 
system mailbox, his mbox file, or his edit file in —f. 

from (f) Takes a list of messages and prvints their message headers. 

headers (h) Lists the current range of headers, which is an 18 message group. If a “*+”' 
argument is given, then the next 18 message group is printed, and if a *‘—"" argu- 


ment is given, the previous 18 message group is printed. 
help A synonym for ? 
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“hold (ho, also preserve) Takes a message list and marks each message therein to be 
saved in the user’s system mailbox instead of in mbox. Does not override the 
delete command. 


(m) Takes as argument login ye and distribution group names and sends mail 
to vihiogs neonies ihe. 


next (n like + or CR) Goes to the. next message in sequence and types it. With an 
argument list, types the next matching message. 


preserve A synonym for hold. 


print (p) Takes a message list and types out each message on the user’s terminal. 
quit (q) Terminates the session, saving all undeleted, unsaved messages in the user’s 


mbox file in his login directory, preserving all messages marked with hold or 
preserve or never referenced in his system mailbox, and removing all other mes- 
sages from his system mailbox. If new mail has arrived during the session, the 
message ‘‘You have new mail”’ is § given. If given while editing a mailbox file with 
the —f flag. then the edit file is rewritten. A return to the Shell is effected, sas 
the rewrite of edit file fails, in which case the user can escape with the exit com- 


reply (r) Takes a message list and sends mai! ail 
command. The default message mus! not be deieied: 

respond A synonym for reply . 

save (s) Takes a message list and a filename and appends each message in turn to the 


end of the file. The filename in 
count is echoed on the user’s termina. 


;, followed by the line count and character 


set (se) With no arguments, prints ail \ alues. Otherwise, sets option. Argu- 


ments are sof the form “‘option = i “option iad 

shell (sh) Invokes an interactive version of the shell. 

size Takes a message list and prin‘s out the size in characters of each message. 

top Takes a message list and prinis the top few lines of each. The number of lines 
printed is controlled by the variable toglines and defaults to five. 

type (t) A synonym for print . 

unalias Takes a list of names defined by 


alias commands and discards the remembered 
groups of users. The gr nol longer have any significance. 


undelete (u) Takes a message list and marks each one as not being deleted. 


unset Takes a list of option names and discards their remembered values, the inverse of 
7 Set. 
| ~ visual (v) Takes a message list and invokes the display editor on each message. 
a o 2 write (w) A synonym for save. 


eae xi (x) A synonym for exit . 


Here is a summary of the tilde escapes, which are used when composing messages to perform 
cial functions. Tilde escapes are only recognized at the beginning of lines. The name 

“tilde escape’ is somewhat of a misnomer since the actual escape character can be set by the 
option escape. 


ee ~ “Icommand Execute the indicated shell command, then return to the message. 


- “ename... Add the given names to the list of carbon copy recipients. 
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“h 


“m messages 


“r filename 
~s string 
“t name ... 


Y 


“w filename 


~lcommand 


~~ String 
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Read the file ‘‘dead.letter’’ from your home directory into the message. 


Invoke the text editor on the message collected so far. After the editing session is 
finished, you may continue appending text to the message. 


Edit the message header fields by typing each one in turn and allowing the user to 
append text to the end or modify the field by using the current terminal erase and 
kill characters. 


Read the named messages into the message being sent, shifted right one tab. If 
no messages are specified, read the current message. 


Print out the message collected so far, prefaced by the message header fields. 


Abort the message being sent, copying the message to ‘‘dead.letter’’ in your home 
directory if save is Set. 


Read the named file into the message. 
Cause the named string to become the current subject field. 
Add the given names to the direct recipient list. 


Invoke an alternate editor (defined by the VISUAL option) on the message col- 
lected so far. Usually, the alternate editor will be a screen editor. After you quit 
the editor, you may resume appending text to the end of your message. 


Write the message onto the named file. 


Pipe the message through the command as a filter. If the command gives no out- 
put or terminates abnormally, retain the original text of the message. The com- 
mand fnir(1) is often used as command to rejustify the message. 


Insert the string of text in the message prefaced by a single ~ If you have 
changed the escape character, then you should double that character in order to 
send it. 


Options are controlled via the set and unset commands. Options may be either binary. in 
which case it is only significant to see whether they are set or not, or string, in which case the 
actual value is of interest. The binary options include the following: 


append 


ask 


askee 


autoprint 
ignore 


metoo 


quiet 


Save 


Causes messages saved itn nibox to be appended to the end rather than. 
prepended. (This is set in /usr/lib/Mail.rc on version 7 systems.) 


Causes mailto prompt you for the subject of each message you send. If you 
respond with simply a newline, no subject field will be sent. 


Causes you to be prompted for additional carbon copy recipients at the end of 
each message. Responding with a newline indicates your satisfaction with the 
current list. 


Causes the delete command to behave like dp — thus, after deleting a mes- 
sage, the next one will be typed automatically. 


Causes interrupt signals from your terminal to be ignored and echoed as @’s. 


Usually, when a group is expanded that contains the sender, the sender ts 
removed from the expansion. Setting this option causes the sender to be 
included in the group. 


Suppresses the printing of the version when first invoked. 


Causes the message collected prior to a interrupt to be saved on the file 
‘“‘dead.letter’’ in your home directory on receipt of two interrupts (or after a 
“q.) 
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The following options have string values: 


EDITOR Pathname of the text editor to use in the edit command and “e escape. If not 
defined, then a default editor is used. 

SHELL Pathname of the shell to use in the ! command and the ~! escape. A default 
Shell is used if this option is not defined. 

VISUAL Pathname of the text editor to use in the visual command and “v escape. 

escape if defined, the first character of this option gives the character to use in the 
place of ~ to denote escapes. 

record If defined, gives the pathname of the file used to record all outgoing mail. If 
not defined, then outgoing mail is not so saved. 

toplines If defined, gives the number of lines of a message to be printed out with the 
top command; normally, the first five lines are printed. 

FILES 

/usr/spool/mail/= post office 

“/mbox your old mail 

~/.mailre file giving initial mail commands 

/imp/R# temporary for editor escape 

/usr/lib/Mail. helps help files 

/usr/lib/Mail.rc system initialization file 

/bin/mail to do actual mailing 

/etc/delivermail postman 

SEE ALSO 


binmail(1), fmt(1), newaliases(1), aliases(5), deliverrnail(8) 
‘The Mail Reference Manual’ 


AUTHOR 
Kurt Shoens 


BUGS 
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NAME 


make — maintain program groups 


SYNOPSIS 


make { —f makefile ] [ option ] ... file .. 


DESCRIPTION 


Make executes commands in makefile to update one or more target names. Name is typically a 
program. If no —f option is present, ‘makefile’ and ‘Makefile’ are tried in order. If makefile is 
‘—° the standard input is taken. More than one —f option may appear 


Make updates a target if it depends on prerequisite files that have been modified since the tar- 
get was last modified, or if the target does not exist. 


Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a 
blank-separated list of targets, then a colon, then a list of prerequisite files. Text following a 
semicolon, and all following lines that begin with a tab, are shell commands to be executed to 
update the target. If a mame appears on the left of more than one ‘colon’ line, then it depends 
on all of the names on the right of the colon on those lines, but only one command sequence 
may be specified for it. If a name appears on a line with a double colon :: then the command 
sequence following that line is performed only if the name is out of date with respect to the 
names to the right of the double colon, and is not affected by other double colon lines on 
which that name may appear. 


Two special forms of a name are recognized. A name like a(b) means the file named 6 stored 


in the archive named a. A name like a((b)) means the file stored in archive @ containing the 
entry point 8. 


Sharp and newline surround comments. 


The following makefile says that ‘pgm’ depends on two files ‘a.o’ and ‘b.o’, and that they in 
turn depend on ‘.c’ files and a common file ‘incl’. 


pgm: a.o b.o 

cc 4.0 b.o —Im —o pgm 
a.o: incl a.c 

cc Cc a.c 
b.o: incl b.c 

ce —c b.c 


Makefile entries of the form 
string] = string2 


are macro definitions. Subsequent appearances of S(string/) are replaced by string2. If string] is 
a single character, the parentheses are optional. 


Make infers prerequisites for files for which makefile gives no construction commands. For 
example, a ‘.c’ file may be inferred as prerequisite for a ‘.o’ file and be compiled to produce the 
‘o’ file. Thus the preceding example can be done more briefly: 


pgm: a.o b.o 
cc 2.0 b.o —im —o pgm 
a.o b.o: incl 


Prerequisites are inferred according to selected suffixes listed as the ‘prerequisites’ for the spe- 
cial name ‘.SUFFIXES’; multiple lists accumulate; an empty list clears what came before. 
Order is significant; the first possible name for which both a file and a rule as described in the 
next paragraph exist is inferred. The default list is 


SSUFFIXES: .out .o.c.e.r.f.y .}.s .p 
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The rule to create a file with suffix 52 that depends on a similarly named file with suffix s/ is 
specified as an entry for the ‘target’ s/s2. In such an entry, the special macro $+ stands for the 
target name with suffix deleted, $@ for the full target name, $< for the complete list of prere- 
quisites, and $? for the list of prerequisites that are out of date. For example, a rule for mak- 
ing optimized ‘.o’ files from ‘.c’ files is 

| c.0:;c¢ ~c ~O —0 $@ $e.c 
Certain macros are used by the default inference rules to communicate optional arguments to 
any resulting compilations. In particular, ‘CFLAGS’ is used for cc(1) options, ‘FFLAGS’ for 
{77(1) options, ‘PFLAGS’ for pc(1) options, and ‘LFLAGS’ and ‘YFLAGS’ for lex and yacc(1) 
opuons. 
Command lines are executed one at a time, each by its own shell. A line is printed when it is 
executed unless the special target ‘SILENT’ is in makefile, or the first character of the com- 
mand is ‘@’. 
Commands returning nonzero status (see intro(1)) cause make to terminate unless the special 
target ‘IGNORE’ is in makefile or the command begins with <tab><hyphen>. 
Interrupt and quit cause the target to be deleted unless the target depends on the special name 
* PRECIOUS. 
Other options: 
—j Equivalent to the special entry “IGNORE®’. 
~k When a command returns nonzero status, abandon work on the current entry, but con- 

tinue on branches that do not depend on the current entry. | 

—n Trace and print, but do not execute the commands needed to update the targets. 
—t Touch, i.e. update the modified date of targets, without executing any commands. oe 
—r Equivalent to an initial special entry ‘“.SUFFIXES:’ with no list. 
—S Equivalent to the special entry ‘.SILENT>’. 


FILES 
makefile, Makefile 

SEE ALSO 
sh(1), touch(1), f77(1), pe()) 
S. I. Feldman Make -- A Program for Maintaining Computer Programs 

BUGS 
Some commands return nonzero status inappropriately. Use —i to overcome the difficuity. 
Commands that are directly executed by the shell, notably cd(1), are ineffectual across newlines 
in make. 
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MAME 
man — find manual information by keywords; print out the manual 

SYNOPSIS 
man —-k keyword ... 
man —f file ... 
man [— ]{—t] [section ] title ... 

DESCRIPTION 
Man is a program which gives information from the programmers manual. It can be asked 
form one line descriptions of commands specified by name, or for all commands whose descrip- 
tion contains any of a set of keywords. It can also provide on-line access to the sections of the 
printed manual. 
When given the option —k and a set of keywords, man prints out a one line synopsis of each 
manual sections whose listing in the table of contents contains that keyword. 
When given the option —f and a list of file names, man attempts to locate manual sections 
related to those files, printing out the table of contents lines for those sections. 
When neither -k nor ~f is specified, man formats a specified set of manual pages. If a section 
specifier is given man looks in the that section of the manual for the given titles. Section is an 
arabic section number, i.e. 3, which may be followed by a single letter classifier, i.e. 1g indicat- 
ing a graphics program in section |. If section is omitted, man searches all sections of the 
manual, giving preference to commands over subroutines in system libraries, and printing the 
first section it finds, if any. 
If the standard output is a teletype, or if the flag — is given, then man pipes its output through 
cat(i) with the option —s to crush out useless blank lines, u/(1) to create proper underlines for 
different terminals, and through more(1) to stop after each page on the screen. Hit a space to 
continue, a control-D to scroll 11 more lines when the output stops. 
The —t flag causes man to arrange for the specified section to be troffed to a suitable raster out- 
put device; see vrroff(1). 

FILES 
/usr/man/man?/+ 
fusr/man/cat?/# 

SEE ALSO 
more(1), ul(1), whereis(1), catman(8) 

BUGS 


The manual is supposed to be reproducible either on the phototypesetter or on a typewriter. 
However, on a typewriter some information is necessarily lost. 
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NAME 
mesg — permit or deny messages 


SYNOPSIS 
mesg [n] [y] 

DESCRIPTION 
Mesg with argument n forbids messages via write(1) by revoking non-user write permission on 
the user’s terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the 
current state without changing it. 


FILES 
/dev/tty* 


SEE ALSO 
write(1) 


DIAGNOSTICS 
Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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Mkdir creates specified directories in mode 777. Standard entries, *.’, for the directory itself, 
and *..” for its parent, are made automatically. 


Mkdir requires write permission in the parent directory. 
rm(1) 
DIAGNOSTICS 


Mkdir returns exit code 0 if all directories were successfully made. Otherwise it prints a diag- 
nostic and returns nonzero. 
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kstr — create an error message file by massaging C source 


[ — ] messagefile prefix file ... 
& Pp 


RI PTION 


Mksrr is used to create files of error messages. Its use can make programs with large numbers 
of error diagnostics much smaller, and reduce systern overhead in running the program as the 
error messages do not have to be constantly swapped itn and out. 


Mkstr will process each of the specified Ales, placing a massaged version of the input file in a file 
whose name consists of the specified prefix oo the original name. A typical usage of mxsir 
would be 


e 


mikstr pisirings xx *.c 


* 


This command would cause all the error messages from the C source files in the current direc- 
tory to be placed in the file pistrings and processed copies of the source for these files to be 
placed in files whose names are prefixed with xx. 


To process the error messages in the source to the message file mxkstr keys on the string 
‘error(”’ in the input stream. Each time it occurs, the C string starting at the ‘"’ is placed in the 
message file followed by a nuil character anda pied character; the null character terminates 
the message so it can be easily used when retrieved, the new-line character makes it possible to 
sensibly caf the error message file to see its contents. The massaged copy of the input file then 
contains a /seek pointer into the file which can be used to retrieve the message, l.e.: 


char efilname{] = "/usr/lib/pi_strings’; 
int efi] == -1; 


error(al, a2, a3, a4) 


. 
char buf[256]; 
if (efil < 0) { 
efil = open(efilname, 0); 
if (efil < 0) { 
oops: 
perror(efilname): 
exit(1): 
if (Iseek(efil, (long) al, 0) | read(efil, buf, 256) <= 0) 
goto oops; 
printf(buf, a2, a3, a4); 
} 


The optional — causes the error messages to be placed at the end of the specified message file 
for recompiling part of a large mxs¢r ed program. 


SEE ALSO 
iseek (2), xstr(1) 
AUTHORS 


William Joy and Charles Hale 
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NAME 
more, page — file perusal filter for crt viewing 
SYNOPSIS 
more [ —cdfisn ] [ —2] [ + linenumber] { +/pattern] [ name... ] 
page more options 
DESCRIPTION 


More is a filter which allows examination of a continuous text one screenful at a time on a 
soft-copy terminal. It normally pauses after each screenful, printing --More-- at the bottom of 
the screen. If the user then types a carriage return, one more line is displayed. If the user hits 
a space, another screenful is displayed. Other possibilites are enumerated later. 


The command line options are: 


—n An integer which is the size (in lines) of the window which more will use instead of the 
default. 


—¢ More will draw each page by beginning at the top of the screen and erasing each line 
just before it draws on it. This avoids scrolling the screen, making it easier to read 
while more is writing. This option will be ignored if the terminal does not have the 
ability to clear to the end of a line. 


~¢ More will prompt the user with the message "Hit space to continue, Rubout to abort” at 
the end of each screenful. This is useful if more is being used as a filter in some set- 


ting, such as a class, where many users may be unsophisticated. 


={ This causes more to count logical, rather than screen lines. That is, long lines are not 
folded. This option is recommended if nroffoutput is being piped through ui, since the 
latter may generate escape sequences. These escape sequences contain characters which 
would ordinarily occupy screen postions, but which do not print when they are sent to 
the terminal as part of an escape sequence. 


Thus more may think that lines are longer 
than they actually are, and fold lines erroneously. 


—| Do not treat “L (form feed) specially. If this option is not given, more will pause after 
any line that contains a “L. as if the end of a screenful had been reached. Also, if a file 
begins with a form feed, the screen will be cleared before the file is printed. 


—s§ Squeeze multiple blank lines from the output, producing only one blank line. Espe- 


cially helpful when viewing »roffoutput, this option maximizes the useful information 
present on the screen. 


— i Normally, more will handle underlining such as produced by nroffin a manner appropri- 
ate to the particular terminal: if the terminal can perform underlining or has a stand- 
out mode, more will output appropriate escape sequences to enable underlining or 
stand-out "ode for underlined information in the source file. The -—uwu option 


suppresses this processing. 


+ linenumber 
Start up at linenumber. 


+ / partern 
Start up two lines before the line containing the regular expression pattern 
If the program is invoked as page, then the screen is cleared before each screenful is printed 


(but only if a full screenful is being printed), and k ~ 1 rather than & — 2 lines are printed in 
each screenful, where kis the number of lines the terminal can display. 


More looks in the file /efc/termcap to ee ta terminal characteristics, and to determine the 
default window size. On a terminal capable of displaying 24 lines, the default window size is 22 
lines. 
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More looks in the environment variable MORE to pre-set any flags desired. For example, if 
you prefer to view files using the —c mode of operation, the csh command serenv MORE -c or 
the sh command sequence MORE™=’-c’ ; export MORE would cause all invocations of more , 
including invocations by programs such as man and msgs , to use this mode. Normaily, the 
user will place the command sequence which sets up the MORE environment variable in the 
.cshrcor .profiie file. 


If more is reading from a file, rather than a pipe, then a percentage is displayed along with the 
More-- prompt. This gives the fraction of the file (in characters, not lines) that has been read 
so far. 


Other sequences which may be typed when more pauses, and their effects, are as follows (/is an 
optional integer argument, defaulting to 1) : 


i< space > 

display imore lines, (or another screenful if no argument is given) 
“D display 11 more lines {a ‘‘scroll"’). If jis given, then the scroll size is set to /. 
d same as “D (control-D) 
iZ same as typing a space except that ij, if present, becomes the new window size. 
is skip i lines and print a screenful of lines 
if skip iscreenfuls and print a screenful of lines 


qorQ Exit from more. 


a Display the current line number. 
Vv Start up the editor viat the current line. ; 
h Help command, give a description of all the more commands. 


i/expr search for the i-th occurrence of the regular expression expr. If there are less than / 
occurrences of expr, and the input is a file (rather than a pipe), then the position in the 
file remains unchanged. Otherwise, a screenful is displayed, starting two lines before 
the place where the expression was found. The user’s erase and kill characters may be 
used to edit the regular expression. Erasing back past the first colurmn cancels the 


search command. 


in search for the i-th occurrence of the last regular expression entered. 


(single quote) Go to the point frorn which the last search started. If no search has 
been performed in the current file, this command goes back to the beginning of the file. 


‘command 
invoke a shell with command. The characters ‘%’ and ‘! in “command” are replaced 
with the current file same and the previous shell command respectively. If there is no 
current file name, ‘%” is not expanded. The sequences "\%”" and “\!" are replaced by 


"™%”" and “!" respectively. 

cn skip to the i-th next file given in the command line (skips to last file if n doesn't make 
sense) 

ip skip to the i-th previous file given in the command line. [f this command is given in 


the middie of printing out a file, then more goes back to the beginning of the file. [if i 
doesn’t make sense, more skips back to the first file. If more is not reading from a file, 


the bell is rung and nothing else happens. 
f display the current file name and line number. 
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:q or :Q 
exit from more (same as q or Q). 


(dot) repeat the previous command. 


The commands take effect immediately, i.e., it is not necessary to type a carriage return. Up to 
the time when the command character itself is given, the user may hit the line kill character to 
cancel the numerical argument being formed. In addition, the user may hit the erase character 
to redisplay the --More--(xx%) message. 


At any time when output is being sent to the terminal, the user can hit the quit key (normally 
controi—\). More will stop sending output, and will display the usual --More-- prompt. The 
user may then enter one of the above commands in the normal manner. Unfortunately, some 
output is lost when this is done, due to the fact that any characters waiting in the terminal’s 
output queue are flushed when the quit signal occurs. 


The terminal is set to noecho mode by this program so that the output can be continuous. 
What you type will thus not show on your terminal, except for the / and ! commands. 


If the standard output is not a teletype, then more acts just like cat, except that a header is 
printed before each file (if there is more than one). 


A sample usage of morein previewing nroffoutput would be 
nroff —ms +2 doc.n| more -s 


AUTHOR 

Eric Shienbrood, minor revisions by John Foderaro and Geoffrey Peck 
FILES 

/etc/termecap Terminal data base 


/usr/lib/more.help Help file 


SEE ALSO 


esh(1), man(1), msgs(1), script(1), sh(1), environ (5) 
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NAME 

msgs — system messages and junk mail program 
SYNOPSIS 

msgs [ ~fhipq } [ number } [ —number ] 
DESCRIPTION 


Msgs is used to read system messages. These messages are sent by mailing to the login ‘msgs’ 
and should be short pieces of information which are suitable to be read once by most users of 
the system. 


Msgs is normally invoked each time you login, by placing it in the file ./ogin (profile if you use 
/bin/sh). it will then prompt you with the source and subject of each new message. If there is 
no subject line, the first few non-blank lines of the message will be displayed. If there is more 
to the message, you will be told how long it is and asked whether you wish to see the rest of 
the message. The possible responses are: 


y type the rest of the message 

RETURN 
synonym for y. 

n skip this message and go on to the next message. 

_ redisplay the last message. 

q drops you out of msgs; the next time you run the program it will pick up where you left 
off. 

S append the current message to the file ‘‘Messages”’ in the current directory; ‘s—’ will 


save the previously displayed message. A ‘s’ or ‘s—’ may be followed by a space and a 
filename to receive the message replacing the default ‘‘Messages’’. 


9 


m or ‘m—’ causes a copy of the specified message to be placed in a temporary mailbox 
and mail(1) to be — on that mailbox. Both ‘m’ and ‘s’ accept a numeric argu- 
ment in place of the ‘— 


Msgs keeps track of the next message you will see by a number in the file .msgsrc in your home 
directory. In the directory /usr/msgs it keeps a set of files whose names are the (sequential) 
numbers of the messages they represent. The file /usr/msgs/bounds shows the low and high 
number of the messages in the directory so that msgs can quickly determine if there are no 
messages for you. If the contents of dounds is incorrect it can be fixed by removing it; sisgs will 
make a new dounds file the next time it is run. | 


Options to msgs include: 


={ which causes it not to say ‘“‘No new messages.’’. This is useful in your ./ogin file since 
this is often the case here. 


99 


—g Queries whether there are messages, printing ‘“There are new messages.”’ if there are. 


The command “‘msgs —q”’ is often used in login scripts. 
—h causes msgs to print the first part of messages only. 
| option causes only locally originated messages to be reported. 


num A message number can be given on the command line, causing #isgs to start at the 
specified message rather than at the next message indicated by your .msgsrc fle. Thus 


msgs —h | 
prints the first part of all messages. 


— number 
will cause msgs to start number messages back from the one indicated by your .»isgsrc 
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file, useful for reviews of recent messages. 
—p causes long messages to be piped through more(1). 


Within nisgs you can also go to any specific message by typing its number when msgs requests 
input as to what to do. 


FILES 
/usr/msgs/* database 
~/.msgsrc number of next message to be presented 


AUTHORS 
William Joy 
David Wasley 


SEE ALSO 
mail(1), more(1) 


BUGS 
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NAME 
mt — magnetic tape manipulating program 


SYNOPSIS 
mt [ —t tzapename] command [ count | 


DESCRIPTION 
Mris used to give commands to the tape drive. If a tape name is not specified, /dev/rmt12 is 
used. If a count is not specified, 1 is assumed. 


Here are the commands: 
eof write countend-of-file marks 
fsf space forward count files 
fsr space forward count records 
bsf space backward coun: files 
bsr space backward countrecords 
rew rewind tape 
offi rewind tape and go offline: 


FILES 
/dev/rmte Raw magnetic tape interface 
SEE ALSO 
mt(4), dd(1) 
BUGS 
4th Berkeley Distribution §/11/81 
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NAME 
mv — move or rename files 
SYNOPSIS 
v{-il { —f] ( — ] filel file2 
mv {~-i) { —f) 
DESCRIPTION 
My moves (changes the name of) file! to file2. 


[ — ] file ... directory 


MV (1) 


If file2 already exists, it is removed before file] is moved. If Ale2 has a mode which forbids 
writing, mv prints the mode (see chmod(2)) and reads the standard input to obtain a line; if the 


line begins with y, the move takes place; if not, mv exits. 


In the second form, one or more files are moved to the directory with their original file-names. 


My refuses to move a file onto itself. 
Options: 


—j stands for interactive mode. Whenever a move is to supercede an existing file, the user 
is prompted by the name of the file followed by a question mark. If he answers with a 
line starting with ‘y’, the move continues. Any other reply prevents the move from 


occurring. 


~f stands for force. This option overrides any mode restrictions or the —i switch. 


- means interpret all the following arguments to mvas file names. This allows file nares 


Starting with minus. 
SEE ALSO 
ep(1), In(1) 
BUGS 


If filel and file2 lie on different file systems, mv must copy the file and delete the original. In 
this case the owner name becomes that of the copying process and any linking relationship with 


other files is lost. 


Directories may only be moved within the same parent directory. 
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NAME 
- met — execute a command on a remote machine 


SYNOPSIS 
net [ ~m machine ] { ~I login ] [ ~p password ] [ ~r respfile] [—-][—f] [—n] [—q] 
command 


DESCRIPTION 
The set command sends the specified command (which should be enclosed in quotes) over the 
network to the specified (or default) remote machine. The network will notify the user when 
the command has been executed and will return to him any output or error indication by ‘writ- 
ing’ (see write(1)) to the terminal if he is still logged in, or ‘mailing’ (see mail(1)) otherwise. 


There are a number of options, which must precede the command. Options may be specified 
on the command line, preceding the command, or in a file “‘.netrc’’ in the user’s login direc- 
tory. The ‘‘.netrc’’ file is not described here. The —m option specifies the desired remote 
machine. If a remote machine is not specified, the default one is used. The machine name 
may be a one letter abbreviation or a full name; upper- and lower-case distinctions are 
ignored. If the standard output and standard error files are to be saved, the —r option returns 
to the originating user a file (resp/ile) containing the standard output and error files when the 
command was executed on the remote machine. If this option is used, no message is written 
back. The presence of a non-zero length respfile indicates completion. The —@q option 
suppresses all acknowledgements unless an error occurs, there is epiee from the command, or 
the exit code of command is non-zero. 


If the —f and —p options are not specified, and the login name and password are not in the 
‘* netre’’ file, a remote login name and password is prompted for on the terminal; the —f flag 
forces login name and password prompting. A single — indicates that the standard input from 
the local machine is to be taken and transmitted to the remote machine, where it will be the 
standard input for command. The -n flag forces all acknowledgment and output messages to be 
mailed rather than written on the terminal. Options do not need to be separated by spaces, 1.e. 
either ‘‘~—m C’’ or ‘‘—mC”’ is accepted. There are also other options intended to be used by 
higher level application programs and shell scripts only; they will not be described here. 


The net command prepares a file to be sent to the remote machine and queues it in the ‘net- 
work queue. Netg (1) gives information about the queues. 


AUTHOR 
Eric Schmidt 

FILES 
/usr/spool/berknet/logfile logfile with information about net activity 
/usr/spool/berknet/plogfile? log file including packet transmission statistics 
/usr/spool/berknet/netstat? Statistics file 
/usr/net/network.map local network names and topology 

BUGS 


—q should be the default. 


SEE ALSO 
netrm(1), netq(1), netlog(1), netcp(1), netlpr(1), netmail(1), netlogin(1), mail (1) 
“‘An Introduction to the Berkeley Network", by Eric Schmidt 
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NAME 
netcp — remote copy of files through the net 


SYNOPSIS 


netcp [ —1 login] [ —p password ] [ —f] [—n] [ —q] fromfile tofile 


DESCRIPTION 


Netcp copies files between machines and is similar to cp({1). At least one of /romfile and tofile 
must be remote. The —l, —p, —f, —q, and —n behave exactly as in ner(1). 


From/file and tofile follow these conventions: 
1. A simple filename is assumed to be local and from the current directory. 


2. A filename preceded by a machine designator (see below) is a reference to a file on the 
specified remote machine. If a full pathname is not given, it is assumed to be from the 
login directory. 


Examples: | 
grades.p file in the current directory on local machine 
C:junk file in your login directory on C 
/usr/lib/pq file on local machine 
C:comp/c2.c file in a subdirectory on C machine 


When files are being ‘‘fetched’’, that is, the /rom/file is remote and the fofile is local, the tofile is 
created zero-length mode 600. For security reasons, when the ‘‘fetched’’ file’s contents arrive 
at the local machine, the file must still be zero-length and mode 0600. No confirmation is sent 
to the user that the file has been ‘‘fetched’’; a non-zero file length indicates completion. 


Netcp executes the net(1) command. 


SEE ALSO 


net(1), netrm(1), netq(1), netlog(1), netlpr(1), netmail(1), netlogin(1), ep(1), mail(1) 


AUTHOR 


BUGS 


Eric Schmidt 


The second filename may not be defaulted to a directory name as in cp(1), it must be given 
explicitly. | 
The file mode may or may not be set correctly. 
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NAME 
netlog — print the last few lines of the network log file 
SYNOPSIS 
netlog [ —lines | 
DESCRIPTION 
Netlog prints the last few lines of the network log file indicating recent network activity. 
FILES 
/usr/spool/berknet/logfile the log 
SEE ALSO 


- met(1), netrm(1), netq(1), netep(1), netipr(1), netmail(1), netlogin(1), mail(1) 
BUGS 
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NAME 

netlogin — provide login name and password for a remote machine 
SYNOPSIS 

netlogin —m machine [ —] login ] 
DESCRIPTION 


The netlogin command sets the login name and password for the specified machine in a rather 
unusual way. The user should type (to the C shell) 


setenv MACH machine ‘netlogin —m machine 
or (to the default Version 7 ‘‘Bourne’”’ shell) 
MACH machine= netlogin —m machine’, export MACH machine 
to his login shell. (Note the back-quotes). For example, 
setenv MACHA ‘netlogin —m A‘ 
will prompt the user for his login name and password on the A machine and 
setenv MACHA ‘netlogin —m A —l myname‘ 
will prompt the user for the password to account ‘A:myname’. 


The net(1) command will read the environment looking for environment variables beginning 
with ““MACH”’ and followed by a valid machine name on the local network. If found it will 
use that information rather than prompt the user every time he executes a network command. 
This environment information is ignored if login names and passwords are specified on the 
command line of network commands using the —1 and —p options or in the .errc file. 


This procedure for specifying passwords is somewhat safer than putting the remote passwords in 
the .netrc file. The passwords in the environment are encrypted and the environment informa- 
tion is useless after the user logs out. Use the printenv(1) command to see the encrypted pass- 
word. 


AUTHOR 
Eric Schmidt 


SEE ALSO | 
net(1), netrm(1), netq(1), netlog(1), netep(1), netIpr(1), netmail(1), printenv(1), csh(1) 


BUGS 


4th Berkeley Distribution 2/6/80 1-161 


NETLPR (1) UNIX Programmer’s Manual NETLPR (1) 


NAME. 
netipr — use a remote lineprinter through the net 


SYNOPSIS 
netiIpr [ —m machine } [ —1 login ] [ —p password ] [ —f] [ ~q] {[ ~n ] [ —c command ] [ 
namel ... namen | 

DESCRIPTION 
Netlpr sends the named files, (or the standard input if none are named), to a remote line- 
printer; the —m option forces the files to be printed on the specified machine. (If not 
specified, the default machine is used.) The —l, ~p, —f, —q, and —n options behave exactly 
as in ner(1). If the —e option is specified, the command is used in place of ‘ipr’. This allows 
the use of different lineprinters on the remote machine. See the file /usr/net/network.map’ for a 
list of available commands. Any other options are passed through to /pr(1) on the remote 
machine. Copies of the files are not made on the remote machine. 


Netipr executes the ner(1) command. 


FILES 

/usr/net/network.map lists the allowed local printer names 
SEE ALSO 

net(1), netrm(1), netq(1), netlog(1), netcp(1), netmail(1), netlogin(1), mail(1), Ipr(1) 
AUTHOR 


Eric Schmidt 
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NAME 


netmail — read mail on a remote machine over the network 


SYNOPSIS 


netmail [ —1 username ] [ —p password ] [ —c] [ ~q] [ —n] [ —f] [ machine:username ] 


DESCRIPTION 


Mail is checked and/or read on the specified machine. If the machine specification is omitted, 
the default machine is used. The command has two distinct modes depending on whether the 
“c option is specified. 


If —c is specified, the presence of mail is checked on the remote machine. No password is 
required so it can be put in C shell ‘.netrc’ file. A message is written or mailed back (see 
net(1)) if there is or is not any unread mail. 


If the —e option is not specified, mail is read and mailed back to the user. A password is 
required. Mail is also appended to the remote file ‘mbox’as a precaution. 


The —q option suppresses the message sent back if there is no mail. The options —l, —p, ~—f, 
and —n behave exactly as in mef(1). (The login name can be specified either with the —1 
option or by ‘machine:username’.) 


Netmail executes the ner(1) command. 


Examples: 
netmail —c X:uname checks if there is mail for ‘uname’ on the X machine, no 
password required. 
netmail X:uname reads mail for ‘unarne’ on the X machine, mails it back, pass- 
word is required. 
AUTHOR 


Eric Schmidt 


SEE ALSO 


BUGS 


net(1), netrm(1), netq(1), netlog(1), netcp(1), netipr(1), netlogin(1), mail(1) 
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power 


NAME 

netq — print contents of network queue 
SYNOPSIS 

netq [ ~a] [ machine ] 
DESCRIPTION 


Netg lists the contents of the network queue, one request per line, for each directly-connected 
machine. For each request, it shows the login name and machine of the originator, the destina- 
tion machine and login name, and the length (in bytes) of the request (this will be larger than 
any files transferred (e.g. by zetcp), because of header information). Also described are the 
queue filename which may be used as an argument to retrm(1), the time entered the queue, 
and the command being sent. 


Netg summarizes requests by other users. If the -a option is specified, requests from all users 
are listed. 


If a machine is specified, only the queue for that directly-connected machine is listed. 


The requests are listed in the order they will be sent; the queue for each machine is totally 
independent from the other machine’s queues. 


AUTHOR 
Eric Schmidt 

FILES 
/usr/spool/berknet/send? the directories where the queues are 
/usr/spool/berknet/logfile the log 

SEE ALSO 


net(1), netrm(1), netlog(1), netcp(1), netlpr(1), netmail(1), netlogin(1), mail(1) 


BUGS 
Netg should also list files in net queues on intermediate machines. : 
The commands are sent shortest-job first. There is no way to delay a shorter, earlier request. 
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NAME 

netrm — remove a command from the network queue 
SYNOPSIS 

netrm { — ] [namel ... namen ] 
DESCRIPTION 


Netrm removes files from the network queue which have been queued for transmission to 
remote machines (but not yet sent). The names specified are the filenames reported by the 
netq(1) command. The — option indicates that all files owned by the person logged in are to 
be removed. 


Only the owner of the file or super-user can netrm the file. 
AUTHOR 

Eric Schmidt 
FILES 

/usr/spool/berknet/send? the directories where the queues are 
BUGS 


Files on network queues on intermediate machines cannot be removed. 


There should be a —m flag to use with — to remove all your requests to one particular 
machine. 


SEE ALSO 
net(1), netq(1), netcp(1), netlpr(1), netmail(1), netlogin(1), mail(1) ~ 
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NAME 


nettroff — troff 
SYNOPSIS 

nettroff troff arguments 
DESCRIPTION 


Nettroff runs troffl1) and sends the output over the network to the machine at the Computer 
Center with the phototypesetter (currently the ‘‘A’’ machine.) It will prompt you for an 
account mame and password on the A machine unless you have provided these in your .netrc 
file. The troff—s option is unnecessary and not permitted. 


to the photolypeseiter over the network 


Nettrof jobs are limited to 15 feet of typesetter output. It is also a good idea to limit the size of 
the individual files sent, as the network uses a shortest-job-first scheduling algorithm. Jobs of 
25000 characters or less are preferable; in no case will the network accept jobs longer than 
100000 characters. 

SEE ALSO 


viroff(1), net(1), troff() 
BUGS 

There is no way to specify special font mounts on the A machine. 
The —1l and —p options of the met(1) command may not be specified. 
This command is not supported by the ie aes Center. 


If on a Sompulst Center machine (B, C, D, or E) use the sroff command (see troffl1)) for 
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NAME 

newaliases — rebuild the data base for the mail aliases file 
SYNOPSIS 

newaliases 
DESCRIPTION 


Newalises rebuilds the random access data base for the mail aliases file /usr/lib/aliases. It must 
be run each time /usr/lib/aliases is changed in order for the change to take effect. 


SEE ALSO 
aliases(5), delivermail(8) 


BUGS 
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NAME 

newesh — description of new esh features (over oldcsh) 
SYNOPSIS 

esh csh-options 
SUMMARY 


This is a summary of features new in csh(1) in this version of the system; an older version of 
csh is available as oldcsh. This newer csh has some new process control primitives and a few 
other new features. Users of csh must (and automatically) use the new terminal driver (sum- 
marized in newry(4) and completely described with the old in ¢ty(4)) which allows generation of 
some new interrupt signals from the keyboard which tell jobs to stop, and arbitrates access to 
the terminal; on CRT's the command “‘stty crt’’ is normally placed in the ./ogin file to be exe- 
cuted at login, to set other useful modes of this terminal driver. 


Jobs. 


The most important new feature in this shell is the control of jobs. A job is associated with each 
pipeline, where a pipeline is either a simple command like ‘‘date’’, or a pipeline like ‘“twho | 


we’’. The shell keeps a table of current jobs, and assigns them small integer numbers. When 
you Start a job in the background, the shell prints a line which looks like: 


(1] 1234 


this indicating that the job which was started asynchronously with ‘*&’* is job number 1 and has 
one (top-level) process, whose process id is 1234. The set of current jobs is listed by the jobs 
command. 


If you are running a job and wish to do Somme ining else you may hit the key “Z (control-Z) 
which sends a stop signal to the current job. The shell will then normally indicate that the job 
has been ‘‘Stopped’’, and print naaee prompt. You can then put the job in the background 
with the command ‘‘bg’’, or run some other commands and then return the job to the fore- 
ground with ‘‘fg”*. A “Z takes effect immediately and is like an interrupt in that pending output 
and unread input are discarded when it is typed. There is another special key “Y which does 
not generate a Stop signal until a program attempts to read(2) it. This can usefully be typed 
ahead when you have prepared some commands for a job which you wish to stop after it has 
read them. 


A job being run in the background will stop if it tries to read from the terminal. Background 
jobs are normally allowed to produce output, but this can be disabled by doing “‘stty tostop’’. If 
you set this tty option, then background jobs will stop when they try to produce output like 
they do when they try to read input. | 


There are several ways to refer to jobs in the shell. The character °‘%’’ introduces a job name. 
If you wish to refer to job number ], you can name it as ““%1’’. Just naming a job brings it to 
the foreground; thus ‘‘%1° is a synonym for “fg %1’’, bringing job 1 back into the foreground. 
Similarly saying ‘*%1 &’* resumes job | in the background. Jobs can also be named by prefixes 
of the string typed in to start them, if these prefixes are unambiguous, thus *“%ex’” would nor- 
mally restart a suspended ex(1) job, if there were only one suspended job whose name began 
with the string ‘tex’. It is also possible to say ‘‘%?string’’ which specifies a job whose text con- 
tains siring, if there is only one such Job. 

The shell also maintains a notion of the current and previous jobs. In output pertaining to jobs, 
the current job is marked with a ‘°+”’ and the previous job with a ‘‘—’’. The abbreviation 
**% +°" refers to the current job and “%-—”’ refers to the previous job. For close analogy with 
the Aistory mechanism, ‘“%%"” is also a synonym for the current job. 
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Status reporting. 


This shell learns immediately whenever a process changes state. It normally informs you when- 
ever a job becomes blocked so that no further progress is possible, but only just before it prints 
a prompt. This is done so that it does not otherwise disturb your work. If, however, you set 
the shell variable vozify, the shell will notify you immediately of changes of status in back- 
ground jobs. There is also a shell command notify which marks a single process so that its 
status changes will be immediately reported. By default notify marks the current process; simply 
say “‘notify’’ after starting a background job to mark It. 


When you try to leave the shell while jobs are stopped, you will be warned that ‘‘You have 
stopped jobs.”” You may use the ‘‘jobs’’ command to see what they are. If you do this or 
immediately try to exit again, the shell will not warn you a second time, and the suspended jobs 
will be unmercifully terminated. 


New builtin commands. 


bg 

bg %job ... 
Puts the current or specified jobs into the background, continuing them if they were 
stopped. 


fg 

fg %job ... | 
Brings the current or specified jobs into the foreground, continuing them if they were 
stopped. 

jobs 

jobs —] 
Lists the active jobs; given the —I options lists process id’s in addition to the normal 
information. 


kill %job 

kill —sig %job ... 

kill pid 

kill —sig pid ... 

kill —1 
Sends either the TERM (terminate) signal or the specified signal to the specified jobs or 
processes. Signals are either given by number or by names (as given in 
lusrlincludelsignal.h, stripped of the prefix ‘“‘SIG*’). The signal names are listed by *‘kill 
—|’’, There is no default, saying just ‘kill’ does not send a signal to the current job. If 
the signal being sent is TERM (terminate) or HUP (hangup), then the job or process will 
be sent a CONT (continue) signal as well. 


notify 
notify %job ... 
Causes the shell to notify the user asynchronously when the status of the current or 


specified jobs changes; normally notification is presented before a prompt. All jobs are 
marked ‘‘notify’’ if the shell variable ‘‘notify’’ is set. 


stop %job ... 

Stops the specified job which is executing in the background. 
%iob 

Brings the specified job into the foreground. 
%iob & 

Continues the specified job in the background. 
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Process limitations. 


The sheil provides access to an experimental facility for limiting the consumption by a single 
process of system resources. The following commands control this facility: 


limit resource maximum-use 


limit resource 

limit 
Limits the consumption by the current process and each process it creates to not individu- 
ally exceed maximum-use on the specified resource. If no maximum-use is given, then the 
current limit is printed; if no resource is given, then all limitations are given. 


Resources controllable currently include cputime (the maximum number of cpu-seconds to 
be used by each process), filesize (the largest single file which can be created), datasize 
(the maximum growth of the data+stack region via sérk(2) beyond the end of the pro- 
gram text), sracksize (the maximum size of the automatically-extended stack region), and 
coredumpsize (the size of the largest core dump that will be created). 


The maximum-use may be given as a (floating point or integer) number followed by a 
scale factor. For ail limits other than cputime the default scale is ‘‘k’’ or ‘‘kilobytes” 
(1024 bytes): a scale factor of ‘‘m’’ or ‘‘megabytes’’ may also be used. For cputime the 
default scaling is ‘‘seconds’’, while ‘‘m’’ for minutes or ‘‘h’’ for hours, or a time of the 


form ‘‘mm:ss’’ giving minutes and seconds may be used. 


For both resource names and scale factors, unambiguous prefixes of the nares suffice. 


unlimit resource 

unlimit 
Removes the limitation on resource. If no resource is spe 
tions are removed. 


cified, then ail resource limita- 


Directory stack. 


This shell now keeps track of the current directory (which is kept in the variable cwa) and also 
maintains a stack of directories, which is printed by the command dirs. You can change to a 
new directory and push down the old directory stack by using the cormmand pushd which is oth- 
erwise like the chdir command, changing to its argument. You can pop the directory stack by 
saying popd. Saying pushd with no arguments exchanges the top two elements of the directory 
stack. The elements of the directory stack are numbered from | starting at the top. Saying 
pushd with a argument ‘*+ 7°" rotates the directory stack to make that entry in the stack be at 
the top and changes to it. Giving popd a ‘“‘+n”’’ argument eliminates that argument from the 
directory stack. 


Miscellaneous. 


This shell imports the environment variable USER into the variable user, TERM into ‘erm, and 
HOME into Aome, and exports these back into the environment whenever the normal shell 
variables are reset. The environment variable PATH is likewise handled; it is not necessary to 
worry about its setting other than in the file .csfrc as inferior csh processes will import the 
definition of path from the environment, and re-export it if you then change it. (It could be set 
once in the ./ogin except that commands over the Berknet would not see the definition.) 


There are new commands eva/, which is like the eval of the Bourne sheil sh(1), and useful with 
iset(1), and suspend which stops a shell (as though a “Z had stopped it; since shells normally 
ignore “Z signals, this command is necessary.) 


There is a new variable cdpath; if set, then each directory in cdpath will be searched for a direc- 
tory named in a chdir command if there is no such subdirectory of the current directory. 
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An unsetenv command removing environment variables has been added. 


6&,9? 9 


There is a new modifier ‘*:e’’, which yields the extension portion of a filename. Thus if 
“$a” is “‘file.c’’, ‘*Sa:e’’ is ‘*c’’. | | 

There are two new operators in shell expressions ‘*‘!"’? and ‘‘=~’’ which are like the string 
operations ‘*!="* and ‘‘=="" except that the right hand side is a parrern (containing, e.g. ‘**’’s, 
‘*2°°s and instances of ‘‘[...]’’) against which the left hand operand is matched. This reduces 
the need for use of the switch statement in shell scripts when all that is really needed is pattern 
matching. 


The form “$<” is new, and is replaced by a line from the standard input, with no further 
interpretation thereafter. It may therefore be used to read from the keyboard in a shell script. 


SEE ALSO 


BUGS 


esh(1), killpg(2), sigsys(2), signal(2), jobs(3), sigset(3), tty(4) 


Command sequences of the form ‘ta ; b ; c’’ are not handled gracefully when stopping 1s 
attempted. If you suspend ‘‘b’’, the shell will then immediately execute ‘‘c’’. This is especially 
noticeable if this expansion results from an alias. It suffices to place the sequence of commands 
in ()’s to force it to a subshell, i.e. “‘(a;b;c)’’, but see the next bug. 


Shell builtin functions are not stoppable/restartable. 


Control over output is primitive; perhaps this will inspire someone to work on a good virtual 
terminal interface. In a virtual terminal interface much more interesting things could be done 
with output control. 
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NAME 
newgrp — log in to a new group 


SYNOPSIS 
newgrp group 


DESCRIPTION 
Newegrp changes the group identification of its caller, analogously to /ogin(i). The same person 
remains logged in, and the current directory is unchanged, but calculations of access permis- 
sions to files are performed with respect to the new group ID. 


A password is demanded if the group has a password and the user himself does not. 
Newgrp is known to the sheil, which executes it directly without a fork. 


FILES 
/etc/group, /etc/passwd 


SEE ALSO 
login(1), group(5) 


BUGS 


crentens 
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NAME | 
nice, nohup — run a command at low priority (sh only) 


SYNOPSIS 
nice [ — number ] command [ arguments ] 


nohup command [ arguments ] 


DESCRIPTION 
Nice executes comunand with low scheduling priority. If the number argument is present, the 


priority is incremented (higher numbers mean lower priorities) by that amount up to a limit of 
20. The default number is 10. 


The super-user may run commands with priority higher than normal by using a negative prior- 
ity, e.g. ‘—-—10’. 
Nohup executes command immune to hangup and terminate signals from the controlling termi- 
nal. The priority is incremented by 5. Nohup should be invoked from the shell with ‘&’ in 
order to prevent it from responding to interrupts by or stealing the input from the next person 
who logs in on the same terminal. The syntax of nice ts also different. 

FILES 
nohup.out standard output and standard error file under nohup 


SEE ALSO 
esh(1), nice(2), renice(8) 


DIAGNOSTICS 
Nice returns the exit status of the subject command. 

BUGS 
Nice and nohup are particular to sh(1). If you use csh(1), then commands executed with ‘*&” 
are aulomatically immune to hangup signals while in the background. There is a builtin com- 


mand nohup which provides immunity from terminate, but it does not redirect output to 
nohup. out, 


Nice is built into csh(1) with a slightly different syntax than described here. The form “‘nice 
+10°° nices to positive nice, and ‘‘nice —10”° can be used by the super-user to give a process 
more of the processor. 
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NAME 2 
nm — print name list 

SYNOPSIS 
nm { ~agnopru | [ file ... ] 

DESCRIPTION 


Nm prints the name list (symbol table) of each object fi/e in the argument list. If an argument 
is an archive, a listing for each object file in the archive will be produced. If no /i/e is given, 
the syrnbols in *a.out’ are listed. 


Each symbol name is preceded by its value (blanks if undefined) and one of the letters U 
(undefined), A (absolute), T (text segment symbol), D (data segment symbol), B (bss segment 
symbol), C (common symbol), f file name, or — for sdb symbol table entries (see —a below). 
If the symbol is local (non-external) the type letter is in lower case. The output is sorted alpha- 
betically. 


Options are: 


a | Include all symbols in candidates for printing; normally symbols destined for sdb(1) are 
excluded. | 


—g Print only global (external) symbols. 

—n Sort numerically rather than alphabetically. 

al | Prepend file or archive element name to each output line rather than only once. 
—p Don’t sort; print in symbol-table order. 

TF Sort in reverse order. 

=u Print only undefined symbols. 


SEE ALSO 
ar(1), ar(5), a.out(5), stab(5) 
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NAME 

num — number lines 
SYNOPSIS 

num { file... ] 
DESCRIPTION 


The lines in the specified files, or the standard input, are copied to the standard output pre- 
ceded by line numbers. Tabs remain aligned in the output as the lines are printed preceded by 
the number blank padded to six digits and then 2 spaces. 

Num is actually just the —n option of the car(1) command. 


SEE ALSO 
cat(1), pr(1) 
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NAME 
od — octal dump 


SYNOPSIS 
od [ ~abcdoxDOXw ] [ file ] { [ + Joffset{ .][ b]] 


DESCRIPTION 
Od dumps file in one or more formats as selected by the first argument. If the first argument is 
missing, ~0 is default. The meanings of the format argument characters are: 


b Interpret bytes in octal. 


¢ Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: null=\0, 
backspace =\b, formfeed=\f, newline=\n, return=\r, tab=\t; others appear as 3-digit octal 
numbers. 


Interpret shorts (16 bit words) in decimal. 
Interpret shorts (16 bit words) in octal. 
Produce wide (132 column) output. 
Interpret shorts (16 bit words) in hex. 
Interpret longs (32 bit words) in decimal. 
Interpret longs (32 bit words) in octal. 
Interpret longs (32 bit words) in hex. 


ex OU xX £4 SF & 


The file argument specifies which file is to be dumped. If no file argument is specified, the 
standard input is used. 

The offset argument specifies the offset in the file where dumping is to commence. This argu- 
ment is normally interpreted as octal bytes. If ‘.’ is appended, the offset is interpreted in 
decimal. If ‘b’ is appended, the offset is interpreted in blocks of 512 bytes. If the file argument 
is omitted, the offset argument must be preceded ‘ +’. 


Dumping continues until end-of-file. 


SEE ALSO 
adb(1) 
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NAME 

passwd — change login password 
SYNOPSIS | 

passwd [ name ] 
DESCRIPTION 


This command changes (or installs) a password associated with the user name (your own name 
by default). 


The program prompts for the old password and then for the new one. The caller must supply 
both. The new password must be typed twice, to forestall mistakes. 


New passwords must be at least four characters long if they use a sufficiently rich alphabet and 
at least six characters long if monocase. These rules are relaxed if you are insistent enough. 


Only the owner of the name or the super-user may change a password; the owner must prove 
he knows the old password. 


FILES 
/etc/passwd 


SEE ALSO 
login(1), passwd(5), crypt(3) 
Robert Morris and Ken Thompson, UNIX password security 


1-177 
7th Edition 


PC (1) UNIX Programmer’s Manual PC (1) 


NAME 

pc — Pascal compiler 
SYNOPSIS 

pe [ option] [ ~i name... ] name ... 
DESCRIPTION 


Pc is a Pascal compiler. If given an argument file ending with .p, it will compile the file and 
load it into an executable file called, by default, @.owr. 


A program may be separated into more than one .p file. Pe will compile a number of argument 
.p files into object files (with the extension .o in place of .p). Object files may then be loaded 
into an executable a.ouz file. Exactly one object file must supply a program statement to suc- 
cessfully create an executable a.out file. The rest of the files must consist only of declarations 
which logically nest within the program. References to objects shared between separately com- 
piled files are allowed if the objects are declared in included header files, whose names must 
end with .h. Header files may only be included at the outermost level, and thus declare oniy 
globally available objects. To allow functions and procedures to be declared, an external direc- 
tive has been added, whose use is similar to the forward directive but restricted to appear only 
in .h files. Function and procedure bodies may not appear in .h files. A binding phase of the 
compiler checks that declarations are used consistently, to enforce the type checking rules of 
Pascal. 


Object files created by other language processors may be loaded together with object files 
created by pc. The functions and procedures they define must have been declared in .h files 
included by all the .p files which call those routines. Calling conventions are as in C, with var 
parameters passed by address. 


See the Berkeley Pascal User’s Manual for details. 


The following options have the sare meaning as in cc(1) and /77(1). See /d(1) for load-time 
options. 


—c Suppress loading and produce ‘.o° file(s) from source file(s). 

—g Have the compiler produce additional symbol table information for sdb(1). 
~w Suppress warning messages. 

—p Prepare object files for profiling, see pro/(1). 

-© Invoke an object-code improver. 


-S Compile the named program, and leave the assembler-language output on the 
corresponding file suffixed ‘.s’. (No ‘.o’ is created.). 


“~g outpul 
Name the final output file ouwrput instead of a.out. 


The following options are peculiar to pc. 


~C Compile code to perform runtime checks, verify assert statements, and initialize all vari- 
ables to zero as in pi. 


—b Block buffer the file ourput. 

~i Produce a listing for the specified procedures. functions and include files. 

~{ Make a program listing during translation. 

“gs Accept standard Pascal only; non-standard constructs cause warning diagnostics. 


—z Allow execution profiling with pxp by generating staterment counters, and arranging for 
the creation of the profile data file pmon.our when the resulting object is executed. 
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Other arguments are taken to be loader option arguments, perhaps libraries of pc compatible 
routines. Certain flags can also be controlled in comments within the program as described in 
the Berkeley Pascal User’s Manual. 


FILES 
file.p pascal source files 
/usr/lib/pcO . compiler 
/lib/f code generator 
/usr/lib/pe2 runtime integrator (inline expander) 
/ib/e2 peephole optimizer 
/usr/lib/pe3 Separate compilation consistency checker 
/usr/lib/pe2.Qstrings text of the error messages 
/usr/lib/how_pe basic usage explanation 
/usr/lib/libpe.a intrinsic functions and I/O library 
/usr/lib/libm.a math library 
/lib/libe.a _ Standard library, see intro(3) 

SEE ALSO 


Berkeley Pascal User’s Manual 


— pill), pxp(1), pxref(1), sdb(1) 


DIAGNOSTICS 


For a basic explanation do 
pe 


See pi(l). for an explanation of the error message format. Internal errors cause messages con- 
taining the word SNARK. 


ALTHORS 


BLGS 


Charles B. Haley, William N. Joy, and Ken Thompson 

Retargetted to the second pass of the portable C compiler by Peter Kessler 
Runtime library and inline optimizer by M. Kirk McKusick 

Separate compilation consistency checking by Louise Madrid 


The keyword packed ts recognized but has no effect. 


The binder is not as strict as described here, with regard to the rules about external declarations 
only in ‘.h’ files and including ‘.h’ files only at the outermost level. It will be made to perform 
these checks in its next incarnation, so users are warned not to be sloppy. 


The —z flag doesn’t work for separately compiled files. 


Because the —s option is usurped by the compiler, it is not possible to pass the strip option to 
the loader. Thus programs which are to be stripped, must be run through srrip(1) after the are 
compiled. 
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NAME 


pi — Pascal interpreter code trans 


SYNOPSIS 


pi [ —binpstuwz ] [ ~{ name... ] name. 


DESCRIPTION 


Pi translates the program in the file name.p leaving interpreter code in the file oé/ in the current 
directory. The interpreter code can be executed using px. Pix performs the functions of pi and 
pxfor ‘load and go’ Pascai. 


The following flags are interpreted by pi; the associated options can also be controlled in com- 
ments within the program as described in the Berkeley Pascal User's Manual. 


“—b Block buffer the file ouspur. 


~{ Enable the listing for any spe 
specified include files. 


cified procedures and functions and while processing any 


~| Make a program listing during translation. 

“~n Begin each listed include fle on a new page with a banner line. 

—p Suppress the post- 
limit counting. 

rd Pas d constructs cause warning diagnostics. 

-¢ Suppress runtime tests of subrange variables and treat assert statements as comments. 

—u Card image mode; only the first 72 characters of input lines are used. 

—w Suppress warning diagnostics. 


mortem control flow backtrace if an error occurs; suppress statement 


=s Accept standa ai only; non-standar 


=z Allow execution profiling with pxp by generating statement counters, and arranging for 
the creation of the profile data file pmon.our when the resulting object is executed. 


FILES 
file.p input file 
file.i include file(s) 
/usr/lib/pi_strings text of the error messages 
/usr/lib/how_pi* basic usage explanation 
obj | interpreter code output 
SEE ALSO 
Berkeley Pascal User’s Manual 
pix(1), px(1), pxp(1), pxref(1) 
DIAGNOSTICS 


3rd Berkeley Distribution 4/8/79 


For a basic explanation do 


pi 
In the diagnostic output of the translator, lines containing syntax errors are listed with a flag 
indicating the point of error. Diagnostic messages indicate the action which the recovery 
mechanism took in order to be able to continue parsing. Some diagnostics indicate only that 
the input is ‘malformed.’ This occurs if the recovery can find no simple correction to make the 
input syntactically valid. 


Semantic error diagnostics indicate a line in the source text near the point of error. Some 
errors evoke more than one diagnostic to help pinpoint the error, the follow-up messages begin 
with an ellipsis *...’. 
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The first character of each error message indicates its class: 


E Fatal error; no code will be generated. 
e Non-fatal error. 

Ww Warning — a potential problem. 

S Non-standard Pascal construct warning. 


If a severe error occurs which inhibits further processing, the translator will give a diagnostic 
and then ‘QUIT’. 


AUTHORS 


Charles B. Haley, William N. Joy, and Ken Thompson 
Ported to VAX-11 by Peter Kessler 


BUGS | 
Formal parameters which are procedures and functions are not supported. 


The keyword packed and the function dispose are recognized but have no effect. 


For clarity, semantic errors should be flagged at an appropriate place in the source text, and 
multiple instances of the ‘same’ semantic error should be summarized at the end of a procedure 
or function rather than evoking many diagnostics. 


When include files are present, diagnostics relating to the last procedure in one file may appear 
after the beginning of the listing of the next. 
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NAME 

pix ~ Pascal interpreter and executor 
SYNOPSIS 

pix { —blnpstuwz ] [ ~i name... ] name.p [ argument... ] 
DESCRIPTION 


Pix is a ‘load and go’ version of Pascal which combines the functions of the interpreter code 
translator pi and the executor px. It uses pi to translate the program in the file name.p and, if 
there were no fatal errors during translation, causes the resulting interpreter code to be exe- 
cuted by px with the specified arguments. A temporary file is used for the object code; the file 
obj is neither created nor destroyed. 


FILES 
/usr/bin/pi Pascal translator 
/usr/bin/px Pascal executor 
/tmp/pix???9? temporary 
/usr/lib/how_pix basic explanation 
SEE ALSO 


Berkeley Pascal User’s Manual 
pi(1), px(1) 


DIAGNOSTICS 
For a basic explanation do 


pix 
AUTHORS 
Susan L. Graham and William N. Joy 
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NAME 
plot — graphics filters 
SYNOPSIS 
plot { ~Tterminal [ raster ] ] 
DESCRIPTION 
These commands read plotting instructions (see p/or(5)) from the standard input, and in gen- 
eral produce plotting instructions suitable for a particular terminal on the standard output. 


If no terminal type is specified, the environment parameter STERM (see environ(5)) is used. 
Known terminals are: 


4014 Tektronix 4014 storage scope. 

450  DASI Hyterm 450 terminal (Diablo mechanism). 
300 DASI 300 or GSI terminal (Diablo mechanism). 
300S DASI 300S terminal (Diablo mechanism). 


ver Versatec D1200A printer-plotter. This version of plot places a scan-converted image in 
‘/usr/tmp/raster’ and sends the result directly to the plotter device rather than to the 
standard output. The optional argument causes a previously scan-converted file raster 
to be sent to the plotter. 


FILES 
/usr/bin/tek 
fusr/bin/t450 
/usr/bin/t300 
/ust/bin/t300s 
/usr/bin/vplot 
/ust/tmp/raster 


SEE ALSO 
plot(3), plot(S) 


BUGS 
There is no lockout protection for /usr/tmp/raster. 


7th Edition 
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NAME 

pmerge — pascal file merger 
SYNOPSIS 

pmerge name.p ... 
DESCRIPTION 


Pmerge assembles the named Pascal files into a single standard Pascal program. The resulting 
program is listed on the standard output. It is intended to be used to merge a collection of 
separately compiled modules so that they can be run through pi , or exported to other sites. 


FILES 
/usr/tmp/MGe= default temporary files 


SEE ALSO 
pe(1), pi(]), 
Auxiliary documentation Berkeley Pascal User’s Manual. 


AUTHOR 
M. Kirk McKusick 


BUGS 
Very minimal error checking is done, so incorrect programs will produce unpredictable results. 
Block comments should be placed after the keyword to which they refer or they are likely to 
end up in bizarre places. 
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pr — print file 


SYNOPSIS 


pr [option]... [ file] ... 


DESCRIPTION 


Pr produces a printed listing of one or more fies. The output is separated into pages headed by 


a date, 


the name of the file or a specified header, and the page number. If there are no file 


arguments, pr prints its standard input. 
Options apply to all following files but may be reset between files: 


— 1 
+N 


ae 


— 7 


Produce n-column output. 
Begin printing with page zn. 
Take the next argument as a page header. 


For purposes of multi-column output, take the width of the page to be nm characters 
instead of the default 72. 


Use formfeeds instead of newlines to separate pages. A formfeed is assumed to use up 


two blank lines at the top of a page. (Thus this option does not affect the effective 
page length.) 


Take the length of the page to be 7 lines instead of the default 66. 
Do not print the 5-line header or the S-line trailer normally supplied for each page. 


Separate columns by the single character c instead of by the appropriate amount of 
white space. A missing cis taken to be a tab. ; 


Print all files simultaneously, each in one column, 


Inter-terminal messages via write(1) are forbidden during a pr. 


FILES 


/dev/tty? to suspend messages. 


SEE ALSO 
cat(1) 


DIAGNOSTICS 


There are no diagnostics when pr is printing on a terminal. 
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NAME 
-printenv — print out the environment 
SYNOPSIS 
printeny [ name |] 
DESCRIPTION 


Printenv prints out the values of the variables in the environment. If a name is specified, only 
its value is printed. 


If a name is specified and it is not defined in the environment, printeny returns exit status 1, 
else it returns status 0. 


SEE ALSO 
sh(1), environ(5), esh(1) 


BUGS 
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NAME 

prmail — print out mail in the post office 
SYNOPSIS 

prmail [ user ... ] 
DESCRIPTION 


Prmail prints the mail which waits for you, or the specified user, in the post office. The mail is 
not disturbed. 


FILES 

/usr/spool/mail/* post office 
SEE ALSO 

biff(1), mail(1). from(1), binmail(1) 
BUGS 
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NAME 

prof — display profile data 
SYNOPSIS 

prof i-aj{—t] [—-n J} [—z] [—s] [ —v [ —low [ —Aigh] ]] [aout [ mon.out ... ] J 
DESCRIPTION , 


Prof interprets the file produced by the monitor subroutine. Under default modes, the symbol 
table in the named object file (@.ouwt default) is read and correlated with the profile file (non.ouwt 
default). For each external symbol, the percentage of time spent executing between that sym- 
bol and the next is printed (in decreasing order), together with the number of times that rou- 
line was called and the number of milliseconds per call. If more than one profile file is 
specified, the output represents the sum of the profiles. 


In order for the number of calls to a routine to be tallied, the —p option of cc, /77 or pc must 

have been given when the file containing the routine was compiled. This option also arranges 

for the profile file to be produced automatically. 

Options are: 

—a all symbols are reported rather than just external symbols. 

—| the output is sorted by symbol value. 

—n the oulput is sorted by number of calls 

—§ a summary profile file is produced in mon.sum. This is really only useful when more 
than one profile file is specified. 


—y all printing is suppressed and a graphic version of the profile is produced on the stan- 
dard output for display by the p/or(1) filters. When plotting, the numbers /ow and Avgh, 
by default 0 and 100, may be given to cause a selected percentage of the profile to be 
‘plotted with accordingly higher resolution. | | 


—Z routines which have zero usage (as indicated by call counts and accumulated time) are 
nevertheless printed in the output. 


FILES 
mon.out for profile 
aout for namelist 
mon.sum for summary profile 


SEE ALSO 
monitor(3), profil(2), ec(1), plot(1) 


BUGS 
Beware of quantization errors. © 
Is confused by {77 which puts the entry points at the bottom of subroutines and functions. 
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NAME 
Ps — process status 


SYNOPSIS 
ps [ acegkistuvwx# | 


DESCRIPTION 


Ps prints information about processes. Normally, only your processes are candidates to be 
printed by ps; specifying a causes other users processes to be candidates to be printed; specify- 
ing x includes processes without control terminals in the candidate pool. 


All output formats include, for each process, the process id PID, control terminal of the pro- 
cess TT, cpu time used by the process TIME (this includes both user and system time), the 
state STAT of the process, and an indication of the COMMAND which is running. The state is 
given by a sequence of four letters, e.g. ““RWNA’”’. The first letter indicates the runnability of 
the process: R for runnable processes, T for stopped processes, P for processes in page wait, D 
for those in disk (or other short term) waits, S for those sleeping for less than about 20 
seconds, and | for idle (sleeping longer than about 20 seconds) processes. The second letter 
indicates whether a process is swapped out, showing W if it is, or a blank if it is loaded (in- 
core); a process which has specified a soft limit on memory requirements and which is exceed- 
ing that limit shows >; such a process is (necessarily) not swapped. The third letter indicates 
whether a process is running with altered CPU scheduling priority (nice): if the processes prior- 
ity is reduced, a N is shown, if the process priority has been artificially raised then a ‘<° is 
shown, process running without special treatment have just a blank. The final letter indicates 
any special treatment of the process for virtual memory replacement, the letters correspond to 
options to the vadvise(2) call; currently the possibilities are A standing for VA_ANOM, S for 
VA_SEQL and blank for VA_NORM: an A typically represents a lisp(1) in garbage collection, S 


is typical of large image processing programs which are using virtual memory to sequentiaily 
address voluminous data. 


Here are the options: 


a asks for information about all processes with terminals (ordinarily only one’s own 
processes are displayed). 


Cc prints the command name, as stored internally in the system for purposes of accounting, 
rather than the command arguments, which are kept in the process’ address space. This 
is more reliable, if less informative, since the process is free to destroy the latter informa- 
tion. 

e Asks for the environment to be printed as well as the arguments to the command. 


g Asks for all processes. Without this option, ps only prints ‘“‘interesting’’ processes. 
Processes are deemed to be uninteresting if they are process group leaders. This normally 
eliminates top-level command interpreters and processes waiting for users to login on free 
terminals. 


k causes the file Amcore is used in place of /dev/‘cmem and /dev/mem. This is used for post- 
mortem system debugging. 


] asks for a long listing, with fields PPID, CP, PRI, NI, ADDR, SIZE, RSS. and WCHAN as 
described below. 


s Adds the size SSIZ of the kernel stack of each process (for use by system maintainers) to 


the basic output format. 


tx restricts output to processes whose controlling tty is x (which should be specified as 
printed by ps, e.g. ¢3 for tty3, wofor console, dO for ttyd0, 2? for processes with no tty, 
etc). This option must be the last one given. 


e A user oriented output is produced. This includes fields USER, %CPU, NICE, SIZE, and 
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RSS as described below. 


v A version of the output containing virtual memory statistics is output. This includes 
fields RE, SL, PAGEIN, SIZE, RSS, LIM, TSIZ, TRS, %CPU and %MEM, described 
below. 


w Use a wide output format (132 columns rather than 80). if repeated, e.g. ww, use arbi- 
trarily wide output. This information is used to decide how much of long commands to 
print. | 


x asks even about processes with no terminal. 


A process number may be given, (indicated here by #), in which case the output is res- 
tricted to that process. This option must also be last. 


A second argument telis ps where to look for core if the k option is given, instead of /vmcore. 

A third argument is the name of a swap file to use instead of the default /dev/drum. If a 

fourth argument is given, it is taken to be the file containing the systen’s namelist. Otherwise, 

/vmunix is used. 

Fields which are not common to all output formats: 

USER name of the owner of the process 

%CPU cpu utilization of the process; this is a decaying average over up to a minute of pre- 
vious (real) time. Since the time base over which this is computed varies (since 
processes may be very young) it is possible for the sum of all %CPU fields to exceed 


100%. 

NICE (or NI) process scheduling increment (see nice(2)) 

SIZE virtual size of the process (in 1024 byte units) 

RSS real memory (resident set) size of the process (in 1024 byte units) 

LIM soft limit on memory used, specified via a call to viimit(2);, if no limit has been 
specified then shown as xr 

TSIZ size of text (shared program) image 

TRS size of resident (real memory) set of text 

%MEM percentage of real memory used by this process. 

RE residency time of the process (seconds in core) 

SL sleep time of the process (seconds blocked) 

PAGEIN number of disk i/o's resulting from references by the process to pages not loaded in 
core. 

UID numerical user-id of process owner 

PPID numerical id of parent of process 

cP short-term cpu utilization factor (used in scheduling) 

PRI process priority (non-positive when in non-interruptible wait) 


ADDR _ swap address of the process 
WCHAN event on which process is waiting (an address in the system), with the initial part of 
the address trimmed off e.g. 80004000 prints as 4000. 


F flags associated with process as in /usr/include/sys/proc.h: 
SLOAD 000001 in core 

swapper or pager process 

process being swapped out 

save area flag 

process is being traced 

another tracing flag 

40 user settable lock in core 

process in page wait state 

another flag to prevent swap out 
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SDLYU 


SWEXIT 
SPHYSIO 
SVFORK 
SVFDONE 
SNOVM 


SPAGI 


SANOM 
SUANOM 


STIMO 


SDETACH 
SNUSIG 


000200 
000400 
000800 
001000 
002000 
004000 
008000 
010000 
020000 
040000 
080000 
100000 
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delayed unlock of pages 

working on exiting 

doing physical i/o (bio.c) 

process resulted from vforkQ 

another vfork flag 

no vm, parent in a vfork() 

init data space on demand, from inode 
system detected anomalous vm behavior 
user warned of anomalous vm behavior 
timing out during sleep 

detached inherited by init 

using new signal mechanism 


A process that has exited and has a parent, but has not yet been waited for by the parent is 
marked <defunct>,; a process which is blocked trying to exit is marked <exiting>;, Ps makes 
an educated guess as to the file name and arguments given when the process was created by 
examining memory or the swap area. The method is inherently somewhat unreliable and in any 
event a process is entitled to destroy this information, so the names cannot be counted on too 


searched to find swap device and tty names 


much. 

FILES 
/vmunix system namelist 
/dev/kmem kernel memory 
/dev/drum swap device 
/vmcore core file 
/dev 

SEE ALSO | 
kKill(1), w(1) 

BUGS 


4th Berkeley Distribution 


Things can change while psis running; the picture it gives is only a close approximation to real- 


ity. 
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NAME 

pti — phototypesetter interpreter 
SYNOPSIS 

oti [ file ... ] 
DESCRIPTION 


Pti shows the commands in a stream from the standard output of rroff(1) using troffs —t 
option, interpreting them as they would act on the typesetter. Horizontal motions shows as 
counts in internal units and are marked with ‘<’ and ‘>’ indicating left and right motion. 
Vertical space is called /ead and is also indicated. 


SEE ALSO 
troff(1) 


BUGS 
Too cryptic for normal users, who should use “‘troff —a ...”’. 
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NAMIE 


ptx — permuted index 


SYNOPSIS 


ptx [ option]... [input { output ] ] 


DESCRIPTION 


FILES 


BUGS 


Prx generates a permuted index to file inpur on file output (standard input and output default). 
It has three phases: the first does the permutation, generating one line for each keyword in an 
input line. The keyword is rotated to the front. The permuted file is then sorted. Finally, the 


sorted lines are rotated so the keyword comes at the middle of the page. Prx produces output 
in the form: 


.Xx “tail” "before keyword" "keyword and after” "head" 


where .xx may be an nroff or trofft1) macro for user-defined formatting. The before keyword 
and keyword and after fields incorporate as much of the line as will fit around the keyword when 
it iS printed at the middle of the page. Tai/ and head, at least one of which is an emply string 
"", are wrapped-around pieces small enough to fit in the unused space at the opposite end of the 
line. When original text must be discarded, ‘/” marks the spot. 


The following options can be applied: 


—f Fold upper and lower case letters for sorting. 

—t Prepare the output for the phototypesetter; the default line length ts 100 characters. 

—w nm Use the next argument, nv, as the width of the output line. The default line length ts 72 
characters. 


—gn Use the next argument, v, as the number of characters to allow for each gap among the 
four parts of the line as finally printed. The default gap is 3 characters. 


—o only 
Use as keywords only the words given in the ov/y file. 

—i ignore 
Do not use as keywords any words given in the ynore file. If the —i and —o options 
are missing, use /usr/lib/eign as the igvore file. 


—b break 
Use the characters in the break file to separate words. In any case, tab, newline. and 
space characters are always used as break characters. 


FT Take any leading nonblank characters of each input line to be a reference identifier (as 
to a page or chapter) separate from the text of the line. Attach that identifier as a 5th 
field on each output line. 


The index for this manual was generated using ptx. 


/bin/sort 
/usr/lib/eign 


Line length counts do not account for overstriking or proportional spacing. 
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NAME 
pwd — working directory name 


SYNOPSIS 
pwd 
DESCRIPTION 
Pwd prints the pathname of the working (current) directory. 
SEE ALSO 
ed(1), csh(1) 
BUGS 
In csh(1) the command dirs is always faster (although it can give a different answer in the rare 


case that the current directory or a containing directory was moved after the shell descended 
— into it). 
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NAME 

px — Pascal interpreter 
SYNOPSIS 

px [ obj [ argument ... } ] 
DESCRIPTION 


Px interprets the abstract machine code generated by pi. The first argument is the file to be 
interpreted, and defaults to obj; remaining arguments are available to the Pascal program using 
the built-ins @7gv and argc. Px is also invoked by pix when running ‘load and go’. 


If the program terminates abnormally an error message and a control flow backtrace are printed. 
The number of statements executed and total execution time are printed after normal termina- 


tion. The p option of pi suppresses all of this except the message indicating the cause of abnor- 
mal termination. 


FILES 
obj default object file 
pmon.out profile data file 
SEE ALSO 


Berkeley Pascal User’s Manual 
pi(1), pix(1) 
DIAGNOSTICS 
Most run-time error messages are self-explanatory. Some of the more ‘unusual ones are: 


Reference to an inactive file 
A file other than input or output was used before a call to reser or mewrne. 


Statement count limit exceeded 
The limit of 500,000 executed statements (which prevents excessive looping or recur- 
sion) has been exceeded. 


Bad data found on integer read 
Bad data found on real read 
Usually, non-numeric input was found for a number. For reals, Pascal requtres digits 
before and after the decimal point so that numbers like ‘.1° or “21 evoke the second 
diagnostic. 
panic: Some message | 
Indicates a internal inconsistency detected in px probably due to a Pascal system bug. 
AUTHORS 
Charles B. Haley, William Joy, and Ken Thompson 
VAX-11 version by Kirk McKusick 
BUGS 
Post-mortem traceback is not limited; infinite recursion leads to almost infmite traceback. 
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pxp — Pascal execution profiler 


SYNOPSIS 


pxp | ~acdefjnstuw_ ] [ —23456789 ] [ ~z [ name... ] ] name.p 


DESCRIPTION 
Pxp can be used to obtain execution profiles of Pascal programs or as a pretty-printer. To pro- 
duce an execution profile all that is necessary is to translate the program specifying the z option 
to pi or pix, to execute the program, and to then issue the command 


pxp —z name.p 


A reformatted listing is output if none of the c, t, or z options are specified; thus 


pxp old.p > new.p 


places a pretty-printed version of the program in ‘old.p’ in the file ‘new.p’. 


The use of the following options of pxp is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the 
Berkeley Pascal User’s Manual. 


—a _ Print the bodies of all procedures and functions in the profile; even those which were 
never executed. 

~c Extract profile data from the file core. 

—d Include declaration parts in a profile. 

—e Eliminate include directives when reformatting a file; the include is replaced by the 
reformatted contents of the specified file. 

—-f Fully parenthesize expressions. 

—j Left justify all procedures and functions. 

—n Eject a new page as each file is included; in profiles, print a blank line at the top of the 
page. 

—~s Strip comments from the input text. 

—t Print a table summarizing procedure and function call counts. 

—u Card image mode; only the first 72 characters of input lines are used. 

~w Suppress warning diagnostics. 

—z Generate an execution profile. If no names, are given the profile is of the entire pro- 
gram. If a list of names is given, then only any specified procedures or functions and the 
contents of any specified include files will appear in the profile. 

— _—- Underline keywords. 

—d With da digit, 2 < d < 9, causes pxp to use d spaces as the basic indenting unit. The 
default is 4. 

FILES 

name.p input file 

name.i include file(s) 

pmon.out profile data 

core profile data source with —c 

/usr/lib/how_pxp information on basic usage 
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SEE ALSO 
Berkeley Pascal User’s Manual 
pi(l), px(1) 


DIAGNOSTICS 
For a basic explanation do 
pxp 


Error diagnostics include ‘No profile data in file’ with the ¢ option if the z option was not 
enabled to pi; ‘Not a Pascal system core file’ if the core is not from a px execution; ‘Program 
and count data do not correspond’ if the program was changed after compilation, before 
profiling; or if the wrong program is specified. 


AUTHOR 
William Joy 


BUGS 
Does not place multiple statements per line. 
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NAME 
pxref — Pascal cross-reference program 


SYNOPSIS 
pxref { — ] name 

DESCRIPTION | 
Pxref makes a line numbered listing and a cross-reference of identifier usage for the program in 
name. The optional ‘~’ argument suppresses the listing. The keywords goto and label are 
treated as identifiers for the purpose of the cross-reference. Include directives are not pro- 
cessed, but cause the placement of an entry indexed by ‘#include’ in the cross-reference. 


SEE ALSO 
. Berkeley Pascal User’s Manual 


AUTHOR 
Niklaus Wirth 


BUGS 
Identifiers are trimmed to 10 characters. 
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NAME 
ranlib — convert archives to random libraries 


SYNOPSIS 
ranlib archive ... 


DESCRIPTION 
Ranlib converts each archive to a form which can be loaded more rapidly by the loader, by 
adding a table of contents named __ .SYMDEF to the beginning of the archive. It uses ar(1) 
to reconstruct the archive, so that sufficient temporary file space must be available in the file 
system containing the current directory. 


SEE ALSO 
Id(1), ar(1), lorder(1) 


BUGS 
Because generation of a library by ar and randomization by ranlib are separate, phase errors are 
possible. The loader /d warns when the modification date of a library is more recent than the 
creation of its dictionary, but this means you get the warning even if you only copy the library. 
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NAME 

ratfor — rational Fortran dialect 
SYNOPSIS 

ratfor { option ... ] [ filename ... ] 
DESCRIPTION 


Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides 
control flow constructs essentially identical to those in C: 


Statement grouping: 
{ statement; statement; statement } 


decision-making: 
if (condition) statement [ else statement |] 
switch (integer value) [ 
case integer: statement 
[ default: ] staternent 


loops: while (condition) statement 
for (expression; condition, expression) statement 
do limits statement 
repeat statement [ until (condition) ] 
break 
next 


and some syntactic sugar to make programs easier to read and write: 


free form input: 
multiple statements/line; automatic continuation 


comments: 
# this is a comment 


translation of relationals: 
>, >=, etc., become .GT., .GE.., etc. 


return (expression) 
returns expression to caller from function 


define: define name replacement 


include: 
include filenarne 


Ratfor is best used with f77(1). 


SEE ALSO 
efl(1), 7770) 
B. W. Kernighan and P. J. Plauger, So/rware Tools, Addison-Wesley, 1976. 


1-200 
7th Edition 


REFER (1) UNIX Programmer’s Manual REFER (1) 


NAME 


refer, lookbib — find and insert literature references in documents 


SYNOPSIS 


refer [ option } ... 
lookbib [ file } ... 


DESCRIPTION 


7th Edition 4/1/81 - 


Lookbib accepts keywords from the standard input and searches a bibliographic data base for 
references that contain those keywords anywhere in title, author, journal name, etc. Matching 


references are printed on the standard output. Blank lines are taken as delimiters between 
queries. 


Refer is a preprocessor for aroffor troff{1) that finds and formats references. The input files 
(standard input default) are copied to the standard output, except for lines between .{ and |] 
command lines, which are assumed to contain keywords as for lookbib, and are replaced by 
information from the bibliographic data base. The user may avoid the search, override fields 
from it, or add new fields. The reference data, from whatever source, are assigned to a set of 
wroff strings. Macro packages such as ms(7) print the finished reference text from these strings. 


A flag is placed in the text at the point of reference, by default the references are indicated by 
numbers. 


The following options are available: 


—~ar Reverse the first rauthor names (Jones, J. A. instead of J. A. Jones). If ris omitted all 
. author names are reversed. 


~b Bare mode: do not put any flags in text (neither numbers nor labels). 
— csiring 
Capitalize (with CAPS SMALL CaPs) the fields whose key-letters are in siring. 


—e Instead of leaving the references where encountered, accumulate them until a sequence 
of the form 
k 


SLISTS 

J 
is encountered, and then write out all references collected so far. Collapse references to 
the same source. 7 


~—kx Instead of numbering references, use labels as specified in a reference data line begin- 
ning %x; by default xis L. 


<-> [77,7 
Instead of numbering references, use labe!s made from the senior author's last name and 
the year of publication. Only the first m letters of the last name and the last a digits of 


the date are used. If either mor ,# is omitted the entire name or date respectively 1s 
used. 


—p Take the next argument as a file of references to be searched. The default file is 
searched fast. 


~n Do not search the default file. 


= KEYS 
Sort references by fields whose key-letters are in the keys string; permute reference 
numbers in text accordingly. Implies ~e The key-letters in keys may be followed by a 
number to indicate how many such fields are used, with + taken as a very large number. 
The default is AD which sorts on the senior author and then date; to sort, for example, 
on all authors and then title use -sA +T. 


REFER (1) UNIX Programmer’s Manual! REFER (1) 


When refer is used with eqn, neqn or (bi, refer should be first, to minimize the volume of data 
passed through pipes. 


FILES 
 /usr/dict/papers — directory of default publication lists and indexes 
/usr/lib/refer directory of programs 
SEE ALSO 
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NAME 
reset — reset the teletype bits to a sensible state 
SYNOPSIS 
reset 
DESCRIPTION 
Reset sets the terminal to cooked mode, turns off cbreak and raw modes, turns on nl, and 
restores special characters that are undefined to their default values. 


This is most useful after a program dies leaving a terminal in a funny state; you have to type 
““<LF>reset<LF>” to get it to work then to the shell, as <CR> often doesn’t work; often 
none of this will echo. 
It isn’t a bad idea to follow reset with tser(1) 

SEE ALSO 
stty(1), tset(1) 

BUGS 
Doesn’t set tabs properly; it can’t intuit personal choices for interrupt and line kill characters, 
so it leaves these the old UNIX standards *? (delete) for interrupt and @ for line kill. 


It could well be argued that the shell should be responsible for insuring that the terminal 
remains in a sane state; this would eliminate the need for this program. 
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NAME 
rev — reverse lines of a file 


SYNOPSIS 
rev [ file } ... 


DESCRIPTION 
Rev copies the named files to the standard output, reversing the order of characters in every 


line. If no file is specified, the standard input is copied. 
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NAME 
rm, rmdir — remove (unlink) files 
SYNOPSIS 
rm. [ ~f] { —r] [ ~i]l [ —] file ... 
rmdir dir ... 
DESCRIPTION 


Rm removes the entries for one or more files from a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a file requires write permission in its directory, but 
neither read nor write permission on the file itself. 


If a file has no write permission and the standard input is a terminal, its permissions are printed 
and a line is read from the standard input. If that line begins with ‘y’ the file is deleted, other- 


wise the file remains. No questions are asked and no errors are reported when the —f (force) 
option is given. 


If a designated file is a directory, an error comment is printed unless the optional argument —r 
has been used. In that case, rm recursively deletes the entire contents of the specified direc- 
tory, and the directory itself. 


If the —i (interactive) option is in effect, rm asks whether to delete each file, and, under —r, 
whether to examine each directory. 


The null option — indicates that all the arguments following it are to be treated as file names. 
This allows the specification of file names starting with a minus. 


Rmdir removes entries for the named directories, which must be empty. 


SEE ALSO 


unlink (2) 


DIAGNOSTICS 


Generally self-expianatory. It is forbidden to remove the file ‘... merely to avoid the antisocial 
consequences of inadvertently doing something like ‘rm —r.*. 
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rewind — rewind tape drive 


SYNOPSIS 
rewind : tape ] 
Rewind rewinds the tape drive, if a tape is mounted on it. This is done by opening and closing 
the tape drive, using a file name that will rewind when the file is closed. If an argument is 
given that is taken as the name of the tape drive rather than the default /dev/mtd. 


Mark Horton 


FILES 
fdev/mt0 
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NAME 


script — make typescript of terminal session 


SYNOPSIS 


script [ -a] [ —q][—S shell ] [ file ] 


DESCRIPTION 


Script makes a typescript of everything printed on your terminal. The typescript is saved in a 
file, and can be sent to the line printer later with /pr. If a file name is given, the typescript is 
saved there. If not, the typescript is saved in the file npescript. 


To exit Script, type control D. This sends an end of file to all processes you have started up, 


and causes script to exit. For this reason, control D behaves as though you had typed an 
infinite number of control D’s. : 


This program is useful when using a crt and a hard-copy record of the dialog 1s desired, as fora 
student handing in a program that was developed on a crt when hard-copy terminals are in short 
supply. 

—S lets you specify the shell to use. The default depends on the system: If the variable 
SHELL is set in the environment, it is used if possible. 


The -q flag asks for ‘‘quiet mode’’, where the “‘script started’’ and ‘script done’’ messages are 


turned off. The -a flag causes script to append to the typescript file instead of creating a new 
file. 


AUTHOR 


BUGS 


Mark Horton 


Since UNIX has no way to write an end-of-file down a pipe without closing the pipe, there is no 
way to simulate a single control D without ending script. 


The new shell has its standard input coming from a pipe rather than a tty, SO stty will not work, 
and neither will ttyname. In particular, this. means that screen editors such as w(1) and the job 
control facilities of csh(1) are inoperative. 


When the user interrupts a printing process, script attempts to flush the output backed up in the 
pipe for better response. Usually the next prompt also gets flushed. 
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NAME 

sdb — symbolic debugger 
SYNOPSIS 

sdb [ objfil [ corfil { directory ] J ] 
DESCRIPTION 


Sdb is a symbolic debugger which can be used with C, PASCAL, and F77 programs. It may be 
used to examine their files and to provide a controlled environment for their execution. 


Objfil is an executable program file which has been compiled with the -g (debug) option. The 
default for odjf/ is a.out. Corfi/ is assumed to be a core image file produced after executing 
objfl, the default for corfilis core. The core file need not be present. 


it is useful to know that at any time there is a current line and current file. If corfil exists then 
they are initially set to the line and file containing the source statement at which the process 
terminated or stopped. Otherwise, they are set to the first line in main. The current line and 
file may be changed with the source file examination commands. 


Names of variables are written just as they are in C, PASCAL, or F77. Variables local to a pro- 
cedure may be accessed using the form ‘procedure:variable’. If no procedure name is given, 
the procedure containing the current line is used by default. It is also possible to refer to struc- 
ture rembers as ‘variable.member’, pointers to structure members as ‘variable->member’ 
and array elements as ‘variable[number]’. Combinations of these forms may also be used. 


It is also possible to specify a variable by its address. All forms of integer constants which are 


valid in C may be used, so that addresses may be input in decimal, octal or hexadecimal. 


Line mumbers in the source program are referred to as ‘filename:number’ or 
‘procedure:number’. In either case the number is relative to the beginning of the file. If no 
procedure or file name is given, the current file is used by default. If no mumber is given, the 
first line of the named procedure or file is used. | 


The commands for examining data in the program are: 
t Print a stack trace of the terminated or stopped program. 
T Print the top line of the stack trace. 


variable//m 
Print the value of variable according to length /and format m. If /and m are omitted, sdb 
chooses a length and format suitable for the variable’s type as declared in the program. 
The length specifiers are: 


b one byte 

h two bytes (half word) 
j four bytes (long word) 
number 


string length for formats s and a 
Legal values for mm are: 


character 

decimal 

decimal, unsigned 

octal . 

hexadecimal 

32 bit single precision floating point 

64 bit double precision floating point 

Assume variable is a String pointer and print characters until a null is reached. 


“se Ce msm 
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a Print characters starting at the variable’s address until a null is reached. 
p pointer to procedure 


The length specifiers are only effective with the formats d, u, o and x. If one of these 
formats is specified and / is omitted, the length defaults to the word length of the host 


machine; 4 for the DEC VAX/11-780. The last variable may be redisplayed with the 
command ‘./’. 


The sh(1) metacharacters » and ? may be used within procedure and variable names, pro- 
viding a limited form of pattern matching. If no procedure name is given, both variables 
local to the current procedure and global (common for F77) variables are matched, while 
if a procedure name is specified then only variables local to that procedure and matched. 
To match only global variables (or blank common for F77), the form ‘:pattern’ is used. 
The name of a common block may be specified instead of a procedure name for F77 pro- 
grams. 

variable = /n 

linenumber = /m 

number =/m 
Print the address of the variable or line number or the value of the number in the 
specified format. If no format is given, then ‘Ix’ is used. The last variant of this com- 
mand provides a convenient way to convert between decimal, octal and hexadecimal. 


variable!value 


Set the variable to the given value. The value may be a number, character constant or a 


variable. If the variable is of type float or double, the value may also be a floating con- 
Stant. 


The commands for examining source files are 


e procedure 

e filename.c 
Set the current file to the file containing the named procedure or the named filename. Set 
the current line to the first line in the named procedure or file. All source files are 
assumed to be in directory. The default for directory is the working directory. If no pro- 
cedure or file name is given, the current procedure and file names are reported. 


/regular expression/ 
Search forward from the current line for a line containing a string matching the regular 
expression as in ed(1). The trailing ‘/’ may be elided. 


regular expression? 
Search backward from the curren’ line for a line containing a siring matching the regular 
expression as in ed(]). The trailing ‘?’ may be eliced. 


p Print the current line. 


z Print the current line followed by the next 9 lines. Set the current line to the last line 
printed. 


control-D 
Scroll. Print the next 10 lines. Set the current line to the last line printed. 


Ww Window. Print the 10 lines around the current line. 


number 
Set the current line to the given line number. Print the new current line. 


count + 
Advance the current line by countlines. Print the new current line. 
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count — 
Retreat the current line by countlines. Print the new current line. | 


The commands for controlling the execution of the source program are: 


county args 
count R 
| Run the program with the given arguments. The r command with no arguments reuses 
the previous arguments to the program while the R command runs the program with no 
arguments. An argument beginning with ‘<’ or ‘>’ causes redirection for the standard 
input or output respectively. If countis given, it specifies the number of breakpoints to be 
ignored. 


linenumber ¢ count 

linenumber C count 
Continue after a breakpoint or interrupt. If count is given, it specifies the number of 
breakpoints to be ignored. C continues with the signal which caused the program to stop 
and ¢ ignores It. 


if a linenumber is specified then a temporary breakpoint is placed at the line and execu- 
tion is continued. The breakpoint is-deleted when the command finishes. 


count § 
Single step. Run the program through count lines. If no count is given then the program 
is run for one line. 


count | 
| Single step, but step through subroutine calls. 


k Kill the debugged program. 


procedure (arg! .arg2,...) 

procedure(arg!,arg2,...)/m 
Execute the named procedure with the given arguments. Arguments can be integer, char- 
acter or string constants or names of variables accessible from the current procedure. The 
second form causes the value returned by the procedure to be printed according to format 
m. If no format is given, it defaults to ‘d’. 

linenumber b commands 
Set a breakpoint at the given line. If a procedure name without a line number is given 
(e.g. ‘proc:’), a breakpoint is placed at the first line in the procedure even if it was not 
compiled with the debug flag. If no linenumber is given, a breakpoint is placed at the 
current line. 


If no commands are given then-execution stops just before the breakpoint and control ts 
returned to sdb. Otherwise the commands are executed when the breakpoint is encoun- 
tered and execution continues. Multiple commands are specified by separating them with 
semicolons. 


linenumber d 
Delete a breakpoint at the given line. If no linenumber is given then the breakpoints are 
deleted interactively: Each breakpoint location is printed and a Jine is read from the stan- 
dard input. If the line begins with a ‘y’ or ‘d’ then the breakpoint is deleted. 


B Print a list of the currently active breakpoints. 
D CDelete all breakpoints. 
I Print the last executed line. 
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FILES 


Announce. If linenumber is of the form ‘proc:number’, the command effectively does a 


‘linenumber b I’. If linenumber is of the form ‘proc:’, the command effectively does a 
"DECC. OI: 


Miscellaneous commands. 


! command 
The command is interpreted by sh(1). 


newline 
If the previous command printed a source line then advance the current line by 1 line and 


print the. new current line. If the previous command displayed a core location then 
display the next core location. 


_" string 


Print the given string. 
q Exit the debugger. 


The following commands also exist and are intended only for debugging the debugger. 
VY __s~wPrint the version number. 

X Print a list of procedures and files being debugged. 

Y Toggle debug output. 


a.out 
core 


SEE ALSO 


adb(1) 


DIAGNOSTICS 


BUGS 


Error reports are either identical to those of adb(1) or are self-explanatory. 


If a procedure is called when the program is not stopped at a breakpoint (such as when a core 
image is being debugged), all variables are initialized before the procedure is started. This 
makes it impossible to use a procedure which formats data from a core image. 


Arrays must be of one dimension and of zero origin to be correctly addressed by sdb. 


The default type for printing F77 parameters is incorrect. Their address is printed instead of 
their value. 


Tracebacks containing F77 subprograms with multiple entry points may print too many argu- 
ments in the wrong order, but their values are correct. 


Sdb understands Pascal, but not its types. 
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Sed ¢ copies the named files (standard input default) to the standard output, edited according to a 


script of commands. The ~f option causes the script to be taken from file s/ile; these options 
accumulate. If there is just one ~e option and no fs, the flag —e may be omitted. Th 
option suppresses the default output. 


A script consists of editing commands, one per line, of the following forrn: 
(address [, address} ] function [arguments] 


In normal operation sed cyclically copies a line of input into a pattern space (unless there is 
something left after a ‘D’ command), applies in sequence all commands whose addresses select 
that pattern space, and at the end of the script copies the pattern space to the standard output 
(except under —n) and deletes the pattern space. 


An address is either a decimal number that counts input lines cumulatively across files, a ‘S$’ 
that addresses the last line of input, or a context address, ‘/regular expression/’, in the style of 
ed(1) modified thus: 


The escape sequence ‘\n’ matches a newline embedded in the pattern space. 
A command line with no addresses selects every pattern space. 
A command line with one address selects each pattern space that matches the address. 


A command line with two addresses selects the inclusive range from the first pattern space that 
matches the first address through the next pattern space that matches the second. (If the 
second address is a number less than or equal to the line number first selected, only one line is 
selected.) Thereafter the process is repeated, looking again for the first address. 


Editing commands can be applied only to non-selected pattern spaces by use of the negation 
function ‘!’ (below). 


In the following list of functions the maximum number of permissible addresses for each func- 
tion is indicated in parentheses. 


An argument denoted text consists of one or more lines, all but the last of which end with ‘\’ to 
hide the newline. Backslashes in text are treated like backslashes in the replacement string of 
an ‘s’ command, and may be used to protect initial blanks and tabs against the stripping that is 
done on every script line. 

An argument denoted file or wftle must terminate the command line and must be preceded by 


exactly one blank. Each w/file is created before processing begins. There can be at most 10 dis- 
tinct wf/e arguments. 


(1) a\ 
text 


Append. Place texron the output before reading the next input line. 


-’ command bearing the /abe/. If lade/is empty, branch to the end of the 


Change. Delete the pattern space. With 0 or 1 address or at the end of a 2-address 
range, place fexron the output. Start the next cycle. 
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(2)d Delete the pattern space. Start the next cycle. 


(2)D Delete the initial segment of the pattern space through the first newline. Start the next 
cycle. 

(2)g Replace the contents of the pattern space by the contents of the hold space. 

(2)G Append the contents of the hold space to the pattern space. 

(2)h Replace the contents of the hold space by the contents of the pattern space. 


(2)H Append the contents of the pattern space to the hold space. 
(1) i\ 


{ext 
Insert. Place texron the standard output. 


(2)n Copy the pattern space to the standard output. Replace the pattern space with the next 
line of input. 


(2)N Append the next line of input to the pattern space with an embedded newline. (The 
current line number changes.) 


(2)p Print. Copy the pattern space to the standard output. 


(2)P Copy the initial segment of the pattern space through the first newline to the standard 
output. 
(1)q Quit. Branch to the end of the script. Do not start a new cycle. 
(2) r rfile 
Read the contents of rfile. Place them on the output before reading the next input line. 
(2) s/regular expression/replacement/flags 
Substitute the replacement string for instances of the regular expression in the pattern 


space. Any character may be used instead of ‘/’. For a fuller description see ed(1). 
Flags is zero or more of 


g Global. Substitute for all nonoverlapping instances of the regular expression 
rather than just the first one. 


p Print the pattern space if a replacement was made. 
w wfile Write. Append the pattern space to w/ile if a replacement was made. 


(2)t label 
Test. Branch to the ‘:’ command bearing the /ade/ if any substitutions have been made 
since the most recent reading of an input line or execution of a ‘t’. If ladel is empty, 
branch to the end of the script. 

Ow vfile 
Write. Append the pattern space to wrile. 

(2)x Exchange the contents of the pattern and hold spaces. 

(2) y/stringl/string2/ 


Transform. Replace all occurrences of characters in string] with the corresponding 
character in string2. The lengths of string] and string2 must be equal. 


(2)! function 
Don’t. Apply the function (or group, if function is ‘{’) only to lines zor selected by the 
address(es). 


(0): label 
This command does nothing; it bears a /abe/ for ‘b’ and ‘t? commands to branch to. 


(1) = Place the current line number on the standard output as a line. 
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(2){ Execute the following commands through a matching ‘}’ only when the pattern space is 
selected. 


(0) An empty command is ignored. 


SEE ALSO 
ed(1), grep(1), awk (1) 
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NAME 

see — see what a fle has in it 
SYNOPSIS | 

see { name... | 
DESCRIPTION 


See prints a file which contains non-printing characters in a readable format. Control characters 
print as “x, for some x; delete prints as “?. For full information see car(1), as see is a synonym 
for the vy option to cat. 

SEE ALSO 
cat (1) 
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/ NAME 
sh, for, case, if, while, ;, ., break, continue, cd, eval, exec, exit, export, login, newgrp, read, 
readonly, set, shift, times, trap, umask, wait — command language 
SYNOPSIS 
sh [ —ceikarstuvx ! [ arg] ... 


Shis a command programming language that executes commands read from a terminal or a file. 
See invocation for the meaning of arguments to the shell. 


Commands. 

A simple-command is a sequence of non blank words separated by blanks (a blank is a tab or a 
space). A word that begins with a # introduces a comment; that word and the rest of the line 
is ignored. 


The first word of a simple-command specifies the name of the command to be executed. 
Except as specified below the remaining words are passed as arguments to the invoked com- 
mand. The command name is passed as argument 0 (see exec(2)). The value of a simple- 
command is its exit status if it terrminates normally or 200+ siarus if it terminates abnormally 
(see signal(2) for a list of status values). 


A pipeline is a sequence of one or more commands separated by |. The standard output of each 
command but the last is connected by a pipe(2) to the standard input of the next command. 
Each command is run as a separate process; the shell waits for the last command to terminate. 


A list is a sequence of one or more pipelines separated by ;, &, && or |! and optionally ter- 
minated by ; or & ; and & have equal precedence which is lower than that of && and li, && 
and !| also have equal precedence. A semicolon causes sequential execution; an ampersand 
causes the preceding pipeline to be executed without waiting for it to finish. The symbol && 
(11) causes the list following to be executed only if the preceding pipeline returns a zero (non 
zero) value. Newlines may appear in a /ist, instead of semicolons, to delimit commands. 


A command is either a simple-command or one of the following. The value returned by a com- 
mand is that of the last simple-command executed in the command. 


for name [in word...) do list done 
Each time a for command is exeeuled name is set to the next word in the for word list 
If in word... is omitted then in °$@* is assumed. Execution ends when there are no 
more words? in the list. 


case word in [ pattern [ | pattern ] 0) Hsess] ... esac 
A case semana executes the Jist associated with the first pattern that matches word. 
The form of the patterns is the same as that used for file name generation. 


if lise then list {elif list then lise] ... lelse /isr] & 
The list following if is executed and if it returns zero the /is:following then is executed. 
Otherwise, the fis: following elif is executed and if its value is zero the /isr following 
then is executed. Failing that the else /isris executed. 


while /ist {do /ist] done 
A while command repeatedly executes the while /istand if its value is zero executes 
the do /ist; otherwise the loop terminates. The value returned by a while command is 
that of the last executed command in the do /ist. until may be used in place of while to 
negate the loop termination test. 


( dist) Execute distin a subshell. 
{ lise} listis simply executed. 
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The following words are only recognized as the first word of a command and when not quoted. 
if then else elif fi case in esac for while until do done { } 
Command substitution. 


The standard output from a command enclosed in a pair of grave accents (‘*) may be used as 
part or all of a word; trailing newlines are removed. 


Parameter substitution. 
The character $ is used to introduce substitutable parameters. Positional parameters may be 
assigned values by set. Variables may be set by writing 


name = value | name= value } .. 


$ { parameter} 
A parameter is a sequence of letters, digits or underscores (a name), a digit, or any of 
the characters > @ # ? — $!. The value, if any, of the parameter is substituted. The 
braces are required only when paramerer is followed by a letter, digit, or underscore that 
is not to be interpreted as part of its name. If paramerer is a digit then it is a positional 
parameter. If parameter is * or @ then al! the positional parameters, starting with $1, 
are substituted separated by spaces. $@ is set from argument zero when the shell is 
invoked. 

$ { parameter — word} 
If parameter is set then substitute its value; otherwise substitute word. 

$ { parameter= word} 
If parameter is not set then set it to word; the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 

$ { parameter ? word} 


If parameter is set then substitute its value; otherwise, print word and exit from the 
shell. If wordis omitted then a standard message is printed. 


$ { parameter+ word) 
If parameter is set then substitute word; otherwise substitute nothing. 


In the above wordis not evaluated unless it is to be used as the substituted string. (So that, for 
example, echo ${d—‘pwd'} will only execute pwdif dis unset.) 


The following parameters are automatically set by the shell. 


a The number of positional parameters in decimal. 

_ Options supplied to the shell on invocation or by set 

? The value returned by the last executed command in decimal. 
$ The process nvicher of thls shiek. 

“he process aumber of ite last vackgrouna Commiana invoked. 


The following parameters are used but not set by the shell. 


OME The default argument (home directory) for the ed command. 
H The search path for commands (see execution). 
MAIL If this variable is set to the name of a mail file then the shell informs the user 
of the arrival of mail in the specified file. 
Primary prompt string, by default ‘3’. 
PS2 Secondary prompt string, by default ‘> ° 
IFS Internal field separators, normaily space, tab, and aewline. 


PS1 


Blank interpretation. 

Mes parameter and command substitution, any results of substitution are scanned for internal 
field separator characters (those found in $IFS) and split into distinct arguments where such 
characters are found. Explicit null arguments (°" or “) are retained. Implicit null arguments 
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(those resulting from parameziers that have no values) are removed. 


File name generation. 

Following substitution, each command word is scanned for the characters *, ? and [. If one of 
these characters appears then the word is regarded as a pattern. The word is replaced with 
alphabetically sorted file names that match the pattern. If no file name is found that matches 
the pattern then the word 1s left unchanged. The character . at the start of a file name or 
immediately following a /, and the character /, must be matched explicitly. 


® Matches any string, including the null string. 

Matches any single character. 

[...] Matches any one of the characters enclosed. A pair of characters separated by — 
matches any character lexically between the pair. 


Quoting. 
The following characters have a special meaning to the shell and cause termination of a word 
unless quoted. 


; & ( ) | < > newline space tab 


A character may be quoted by preceding it with a \. \mewline is ignored. All characters 
enclosed between a pair of quote marks (°"), except a single quote, are quoted. Inside double 
quotes ("*) parameter and command substitution occurs and \ quotes the characters \ ** and $. 


"$e" is equivalent to "$1 $2..." whereas 
"$@" is equivalent to "$1" *$2° .... 


Prompting. 

When used interactively, the shell prompts with the value of PS1 before reading a command. If 
at any time a newline is typed and further input 1s needed to complete a command then the 
secondary prompt ($PS2) is issued. 


Input output. | 

Before a command is executed its input and output may be redirected using a special notation 
interpreted by the shell. The following may appear anywhere in a simple-command or may pre- 
cede or follow a commandand are not passed on to the invoked command. Substitution occurs 
before wordor digitis used. 


< word Use file word as standard input (file descriptor 0). 


> word Use file word as standard output (file descriptor 1). If the file does not exist then it is 
created: otherwise it is truncated to zero length. 


>> word | 
Use file word as standard output. If the file exists then output is appended (by seeking 
to the end); otherwise the file is created. 


<< word 
The shell input is read up to a line the same as word, or end of file. The resulting 
document becomes the standard input. If any character of word is quoted then no 
interpretation is placed upon the characters of the document, otherwise, parameter and 
command substitution occurs, \newline is ignored, and \ is used to quote the characters 
\ $° and the first character of word. 

< & digit 
The standard input is duplicated from file descriptor digit; see dup(2). Similarly for the 
standard output using >. 


<&- The standard input is closed. Similarly for the standard output using >. 
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continue | 7] 
Resume the next iteration of the enclosing for or while loop. If nis specified then 
resume at the mth enclosing loop. 
ed [ arg] 
Change the current directory to arg. The shell parameter SHOME is the default arg. 
eval [ arg... ] 
The arguments are read as input to the shell and the resulting command(s) executed. 
exec [ arg... 
The command specified by the arguments is executed in place of this shell without 
creating a new process. Input output arguments may appear and if no other argumenis 
are given cause the shell input output to be modified. 
exit [ 7] | 
Causes a non interactive shell to exit with the exit status specified by 7. If nis omitted 
then the exit status is that of the last command executed. (An end of file will also exit 
from the shell.) 
export [ name... } 
The given narnes are marked for automatic export to the environment of subsequently- 
executed commands. If no arguments are given then a list of exportable names is 
printed. 
login l arg... ! 
Equivalent to ‘exec login arg ...’. 
newgrp | arg... | 
Equivalent to ‘exec newegrp arg ...’. 
read name... 
One line is read from the standard input; successive words of the input are assigned to 
the variables name in order, with leftover words to the last variable. The return code is 
0 unless the end-of-file is encountered. 
readonly { name...) 
The given names are marked readonly and the values of the these names may not be 
changed by subsequent assignment. If no arguments are given then a list of all 
readonly names is printed. 
set [ —~eknptuvx [ arg...] ] 
~e If non interactive then exit immediately if a command fails. 
-k All keyword arguments are placed in the environment for a command, not just 
those that precede the command name. 
~n Read commands but do not execute them. 
—¢t Exit after reading and executing one command. 
~—u Treat unset variables as an error when substituting. 
~v Print shell input lines as they are read. 
—x Print commands and their arguments as they are executed. 
woe Turn off the —x and ~v options. 


These flags can also be used upon invocation of the shell. The current set of flags may 
be found in $—. 


Remaining arguments are positional parameters and are assigned, in order, to $1, $2, 
etc. If no arguments are given then the values of all names are printed. 


shift The positional parameters from $2... are renamed $1... 
times Print the accumulated user and system times for processes run from the shell. 


trap [ arg] [7]... 
Arg is a command to be read and executed when the shell receives signal(s) nm. (Note 
that arg is scanned once when the trap is set and once when the trap is taken.) Trap 
commands are executed in order of signal number. If argis absent then all trap(s) a 
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are reset to their original values. If argis the null string then this signal is ignored by 
the shell and by invoked commands. If mis 0 then the command arg is executed on 
exit from the shell, otherwise upon receipt of signal mas numbered in signa/(2). Trap 


with no arguments prints a list of commands associated with each signal number. 
umask [ nnn} 
The user file creation mask is set to the octal value nnn (see umask(2)). If nnnis omit- 
ted, the current value of the mask is printed. 
wait [ 7] 


Wait for the specified process and report its termination status. If mis not given then 
all currently active child processes are waited for. The return code from this command 
is that of the process waited for. 


Invocation. 

If the first character of argument zero is —, commands are read from SHOME/. profile, if such a 

file exists. Commands are then read as described below. The following flags are interpreted by 

the shell when it 1s invoked. 

~e string If the ~c flag is present then commands are read from siring. 

—S§ If the —s flag is present o rguments remain then commands are read from 
; the standard input. Shell output is written to file descriptor 2. 

—j If the —i flag is present or if the shell input and output are attached to a terminal 

(as told ey ae aaa this shell is interactive. In this case the terminate signal 


The remaining me and arguments are described under the set command. 


SHOME/ .profile 
/tmp/sh« 
{dev/null 


SEE ALSO 


esh(1), test(1), exec(2), 


DIAGNOSTICS 


Errors detected by the shell, such as syntax errors cause the shell to return a non zero exit 
status. If the shell is being used non interactively then execution of the shell file is abandoned. 
therwise, the shell returns the exit status of the last command exzcuted (see also exit). 


IF << jis used to provide standatd input to an asynchronous process invoked by &, the shell 
gets mixed up about naming the input document. A garbage file /tmp/she is created, and the 
shel! complains about not being able to find the file by another name. 
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NAME 

size — size of an object file 
SYNOPSIS 

size [ object ... ] 
DESCRIPTION 


Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their 
sum in hex and decimal, of each object-file argument. If no file is specified, a.out is used. 


SEE ALSO 
a.out(5) 
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NAME 
sleep — suspend execution for an interval 
SYNOPSIS 
sleep time 
DESCRIPTION 


Sleep suspends execution for time seconds. It is used to execute a command after a certain 
amount of time as in: 


(sleep 105; command) & 
or to execute a command every so often, as in: 


while true 
do 
command 
sleep 37 
done 
SEE ALSO 
alarm(2), sleep (3) 
BUGS 
Time must be less tnan 2147483647 seconds. 
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NAME 
soelim — eliminate .so’s from nroff input 
SYNOPSIS 
soelim [ file... ] 
DESCRIPTION 


Soelim reads the specified files or the standard input and performs the textual inclusion implied 
by the nroff directives of the form 


.so somefile 
when they appear at the beginning of input lines. This is useful since programs such as /d/ do 
not normally do this; it allows the placement of individual tables in separate files to be run as a 
part of a large document. 


aes 


Note that inclusion can be suppressed by using °” instead of ‘.’, i.e. 
‘so /usr/lib/tmac.s 

A sample usage of soelim would be 
soelim exum”.n | tbl | nroff —ms | col | Ipr 


SEE ALSO 

colert(1), more(1) 
AUTHOR 

William Joy 


BUGS 


The format of the source commands must involve no strangeness — exactly one blank must 
precede and no blanks follow the file name. 
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E 
sort — sort or merge files 
SYNOPSIS 
sort { —mubdfinrtx ] [ +posl [ —pos2?]]... [—o name] { —T directory ] [ name ] ... 
DESCRIPTION 
Sort sorts lines of all the named files together and writes the result on the standard output. The 
name ‘-~’ means the standard input. If no input files are named, the standard input is sorted. 


The default sort key is an entire line. Default ordering is lexicographic by bytes in machine 


collating sequence. The ordering is affected globally by the following options, one or more of 
which may appear. 


b Ignore leading blanks (spaces and tabs) in field comparisons. 

d ‘Dictionary’ order: only letters, digits and blanks are significant in comparisons. 
f Fold upper case letters onto lower case. 

i Tgnore characters outside the ASCII range 040-0176 in nonnumeric comparisons. 


n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or 
more digits with optional decimal point, is sorted by arithmetic value. Option n implies 
option b. 


seg 


Reverse the sense of comparisons. 
tx ‘Tab character’ separating fields iS X. 


The notation iri —posé restricts a sort key to a field beginning at pos/ and ending just 
before pose. Posl and pos2 each have the form m.a, optionally followed by one or more of the 
flags bdfinr, where: m tells a number of fields to skip from the beginning of the line and zn tells 
a number of characters to skip further. If any flags are present they override all the global ord- 
ering options for this key. If the b option is in effect nm is counted from the first nonblank in 
the field; b is attached independently to pos2. A missing .» means .0; a missing ~pos2 means 
the end of the line. Under the ~tx option, fields are strings separated by x; otherwise flelds 
are nonempty nonblank strings separated by blanks. 


When there are multiple sort keys, later keys are compared only after all earlier keys compare 
equal. Lines that otherwise compare equal are ordered with all bytes significant. 


These option arguments are also understood: 


c Check that the input file is sorted according to the orderirg rulss; give no output unless 
the file is out of sort. 


rm Merge only, the input files ave already so: ted. 


9 The next argument is the narme of an ou’: u Fle to use instecd of the standard outpui. 
This file may be the same as one of the inputs. 


T The next argument is the name of a directory in which temporary files should be made. 


u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do 
not participate in this comparison. 


Examples. Print in alphabetical order all the unique spellings in a list of words. Capitalized 
words differ from uncapitalizec. 


sort —u +0f +0 list 
Print the password file (passwd(5)) sorted by user id number (the 3rd colon- eenaes field). 
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Sonia 


sort —t: +2n /etc/passwd 


Print the first instance of each month in an already sorted file of (month day) entries. The 
options um with just one input file make the choice of a unique representative from a set of 
equal lines predictable. 


sort ~um +0 —1 dates 


FILES 

/usr/tmp/stm*, /tmp/®* first and second tries for temporary files 
SEE ALSO | 

uniq(1), comm(1), rev(1), join(1) 


DIAGNOSTICS 
Comments and exits with nonzero status for various trouble conditions and for disorder 
discovered under option ~c. 


BUGS 
Very long lines are silently truncated. 
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NAME 


spell, spellin, spellout — find spelling errors 


SYNOPSIS 


FILES 


F [ ° 


DESCRIPTION 


Spell collects words from the named documents, and looks them up in a spelling list. Words 
that neither occur among nor are derivable (by applying certain inflections, prefixes or suffixes) 


from words in the spelling list are printed on the standard output. If no files are named, words 
are collected from the standard input. 


Spell ignores most troff, t/ and egn(1) constructions. 


Under the —yvy option, all words not literally in the spelling list are printed, and plausible deriva- 
tions from spelling list words are indicated. 


Under the ~b option, British spelling is checked. Besides preferring centre, colour, speciality, 


travelled, etc., this option insists upon -ise in words like standardise, Fowler and the OED to the 
contrary notwithstanding. 


Under the ~x option, every plausible stem is printed with ‘=’ for each word. 


The spelling list is based on many sources, and while more haphazard than an ordinary diction- 
ary, is also more effective in respect to proper names and popular technical words. Coverage of 
the specialized vocabularies of biology, medicine and chemistry is light. 


Pertinent auxiliary files may be specified by name arguments, indicated below with their default 
settings. Copies of all output are accumulated in the history file. The stop list filters out 
misspellings (e.g. thier=thy—y-tier) that would otherwise pass. 


Two routines help maintain the hash lists used by spe//. Both expect a list of words, one per 
line, from the standard input. Spellin adds the words on the standard input to the preexisting 
lise and places a new list on the standard output. If no Jist is specified, the new list is created 
from scratch. Spellour looks up each word in the standard input and prints on the standard out- 
put those that are missing from (or present on, with option —d) the hash list. 


D=/usr/dict/hlist{ab]: hashed spelling lists, American & British 
S=/usr/dict/hstop: hashed stop list 

H = /usr/dict/spellhist: history file 

/usr/lib/spell 

deroff(1), sort(1), tee(1), sed(1) 


The spelling list’s coverage is uneven; new installations will probably wish to monitor the out- 
put for several months to gather local additions. 
British spelling was done by an American. 
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NAME 


spline — interpolate smooth curve 


SYNOPSIS 


spline [ option ] ... 


& 


DESCRIPTION | 
Spline takes pairs of numbers from the standard input as abcissas and ordinates of a function. It 


produces a similar set, which is approximately equally spaced and includes the input set, on the 
standard output. The cubic spline output (R. W. Hamming, Numerical Methods for Scientists and 
Engineers, 2nd ed., 349ff) has two continuous derivatives, and sufficiently many points to look 
smooth when plotted, for example by graph(1). 


The following options are recognized, each as a separate argument. 


= 2 


=k 


ome X 


SEE ALSO 


Supply abscissas automatically (they are missing from the input). spacing is given by the 
next argument, or is assumed to be | if next argument is not a number. 


The constant &« used in the boundary value computation 
yo ™ IN Yn ™ n= 


is set by the next argument. By default k = 0. 


Space output points so that approximately 7 intervals occur between the lower and upper x 
limits. (Default » = 100.) 


Make output periodic, i.e. match derivatives at ends. First and last input values should 
normally agree. 


Next 1 (or 2) arguments are lower (and upper) x limits. Normally these limits are calcu- 
lated from the data. Automatic abcissas start at lower limit (default 0). 


graph(1) 


DIAGNOSTICS 
When data is not strictly monotone in x, spline reproduces the input without interpolating extra 
points. 


BUGS 


A limit of 1000 input points is enforced silently. 
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NAME 

split — split a file into pieces 
SYNOPSIS 

split [1] [ file [ name ] ] 


DESCRIPTION 
Split reads file and writes it in n-line pieces (default 1000), as many as necessary, onto a set of 


output files. The name of the first output file is name with aa appended, and so on lexicograph- 
ically. If no output name is given, x is default. 


If no input file is given, or if — is given in its stead, then the standard input file is used. 
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NAME 

strings ~ find the printable strings in a object, or other binary, file 
SYNOPSIS 

strings [| ~ ] [ ~o] [ — umber | file ... 
DESCRIPTION 


Strings looks for ascii strings in a binary file. A string is any sequence of 4 or more printing 
characters ending with a newline or a null. Unless the — flag is given, strings only looks in the 
initialized data space of object files. If the ~o flag is given, then each string is preceded by its 
offset in the file (in octal). If the — number flag is given then number is used as the minimum 
string length rather than 4. 


Strings is useful for identifying random object files and many other things. 


SEE ALSO 
od(1) 
AUTHOR 
Bill Joy 
BUGS | 
The algorithm for identifying strings is extremely primitive 
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NAME 
strip — remove symbols and relocation bits 
SYNOPSIS 
strip name ... 
DESCRIPTION 
Strip removes the symbol table and relocation bits ordinarily attached to the output of the 
assembler and loader. This is useful to save space after a program has been debugged. 
The effect of szrip is the same as use of the —s option of Jd. 
FILES 
/tmp/stm? temporary file 


SEE ALSO 
Id(1) 
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Struct — structure Fortran progra: 


SYNOPSIS 


struct [ option] ... file 


DESCRIPTION 


FILES 


Struct translates the Fortran program specified by file (standard input default) into a Ratfor pro- 
gram. Wherever possible, Ratfor control constructs replace the original Fortran. Statement 
numbers appear only where still necessary. Cosmetic changes are made, including changing 
Hollerith strings into quoted strings and relational operators into symbols (.e.g. ".GT.” into 
">"}. The output is appropriately indented. 


The following options may occur in any order. 


—§ Input is accepted in standard format, i.e. comments are specified by ac, C, or * in 
column 1, and continuation lines are specified by a nonzero, nonblank character in 
column 6. Normally input is in the form accepted by /77(1) 


~—j Do not turn computed goto statements into switches. (Ratfor does not turn switches 
back into computed goto statements.) 


— 9 Turn sequences of else ifs into a non-Ratfor switch of the form 


switch 
{ case predl: code 
case pred?2: code 
case pred3: code 
| default: code 
The case predicates are tested in order; the code appropriate to only one case is exe- 
cuted. This generalized form of switch statement does not occur in Ratfor. 


“mt Generate goto’s instead of multilevel break statements. 
— nD Generate goto’s instead of multilevel next statements. 
—~tn Make the nonzero integer » the lowest valued label in the output program (default 10). 


Y zs 


“cn Increment successive labels in the output program by the nonzero integer a (default 1). 


“~en If nis 0 (default), place code within a loop only if it can lead to an iteration of the loop. 
if mis nonzero, admit a small code segments to a loop if otherwise the loop would have 
exits to several places including the segment, and the segment can be reached only 
from the loop. ‘Small’ is close to, but not equal to, the number of statements in the 
code segment. Values of n under 10 are suggested. 


/tmp/struct® 
/usr/lib/struct/° 


SEE ALSO 


BUGS 


£77(1) 


Struct knows Fortran 66 syntax, but not full Fortran 77. 

If an input Fortran program contains identifiers which are reserved words in Ratfor, the struc- 
tured version of the program will not be a valid Ratfor program. 

The labels generated cannot go above 32767. 

If you get a goto without a target, try ~e. 
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stty — set terminal options 


SYNOPSIS 


stty [ option ... ] 


DESCRIPTION 


Sty sets certain I/O options on the current output terminal, placing its output on the diagnostic 
output. With no argument, it reports the speed of the terminal and the settings of the options 
which are different from their defaults. With the argument ‘‘all’’, all normally used option set- 
tings are reported. With the argument ‘‘everything’’, everything sry knows about is printed. 
The option strings are selected from the following set: 


— raw 
cooked 
ebreak 


~ cbreak 
~ni 

ni 

echo 
echo 
Icase 

~ lease 
tandem 


— tandem 
tabs 
tabs 

ek 


allow even parity input 

disallow even parity input 

allow odd parity input 

disallow odd parity input 

raw mode input (no input processing (erase, kill, interrupt, ...); parity bit passed 
back) 

negate raw mode 

same as ‘~raw’ 

make each character available to read(2) as received: no erase and kill processing, 
but all other processing (interrupt, suspend, ...) is performed 

make characters available to readonly when newline 1s received 

allow carriage return for new-line, and output CR-LF for carriage return or new-line 
accept only new-line to end lines 

echo back every character typed 

do not echo characters 

map upper case to lower case 

do not map case 

enable flow control, so that the system sends out the stop character when its internal 
queue is in danger of overflowing on input, and sends the start character when it is 
ready to accept further input 

disable flow control 

replace tabs by spaces when printing 

preserve tabs 

set erase and kill characters to # and @ 


For the following commands which take a character argument c you may also specify cas the 
‘“"" or ‘“Sundef’, to set the value to be undefined. A value of *‘”x’’, a 2 character sequence, is 
also interpreted as a control character, with °°"?"" representing delete. 


erase c set erase character to c (default ‘#°, but often reset to “H.) 

kill c set kill character to c (default ‘@’, but often reset to “U.) 

intr c set interrupt character to c (default DEL or ~? (delete), but often reset to “C.) 

quit c set quit character to c (default control \.) 

start c set start character to c (default control Q.) 

stop c set stop character to c (default control S.) 

eof c set end of file character to c (default control D.) 

brik c set break character to c (default undefined.) This character is an extra wakeup caus- 
ing character. 

er0 crl er2 er3 


select style of delay for carriage return (see joczi(2)) 


nl0 all nl2 al3 


select style of delay for linefeed 


tab0 tabl tab2 tab3 
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lect style of delay for tab 
fo Wf select style of delay for form feed 
bsO bsl sel 


ag age 


set all modes suitable for Digital Equipment Corp. operating systems users; (erase, 
kill, and interrupt characters to ~?, “U, and “C, decctiq and ‘‘newcrt’’.) 


tn 300 set all modes suitable for a General Electric TermiNet 300 
ti700 set all modes suitable for Texas Instruments 700 series terrninal 
tek set all modes suitable for Tektronix 4014 terminal 

0 hang up phone line immediately 


50 75 110 134 150 200 300 606 1200 1800 2400 4800 9600 exta extb 
Set terminal baud rate to the number given, if possible. (These are the speeds sup- 
ported by the DH-11 interface). 


A teletype driver which supports the job control processing of csh(1) as introduced in 
newcsh(1) and more functionality that the basic driver is introduced in newrn(4) and fully 
described in ry(4). The following options apply only to it. 


new Use new driver (switching flushes typeahead). 
ert Set options for a CRT (ertbs, ctlecho and, if > = 1200 baud, crterase and crtkill.) 
ertbs Echo backspaces on erase characters. 


prterase For printing terminal echo erased characters backwards within ‘‘\"’ and ‘*/"’. 

erterase Wipe out erased characters with ‘‘backspace-space-backspace.’’ 

—~ecrterase Leave erased characters visible, just backspace. 

ertkill Wipe out input on like kill ala erterase. 

“~ertkill Just echo line kill character and a newline on line kill. 

etlecho | Echo control characters as ‘*°x” (and delete as ‘‘°?*’.) Print two backspaces follow- 
ing the EOT character (contro! D). 

~ctlecho Control characters echo as themselves, in cooked mode EOT (control-D) is not 
echoed. 


decctiq After output is suspended (normally by “S), only a start character (normally “Q) will 
restart it. This is compatible with DEC's vendor supplied systems. 


~decctiq After output is suspended, any character typed will restart it; the start character will 
restart output without providing any input. (This is the default.) 

tostop Background jobs stop if they attempt terminal output. 

~tostop Output from background jobs to the terminal is allowed. 

tilde Convert ‘*~’’ to ‘*”’ on output (for Hazeltine terminals). 

Leave poor ‘**~”” alone. 

Output is being discarded usually because user hit control O (internal state bit). 

Output is not being discarded. 

Input is pending after a switch from cbreak to cooked and will be re-input when a 

read becomes pending or more input arrives (internal state bit). 

Input is not pending. 

Send a signal (SIGTINT) to the terminal control process group whenever an input 

record (line in cooked mode, character in cbreak or raw mode) is available for read- 

ing. 

Don't send input available interrupts. 

Start/stop output on carrier transitions (not implemented). 


Return error if write attempted after carrier drops. 
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litout Send output characters without any processing. 

—litout Do normal output processing, inserting delays, etc. 

nohang Don’t send hangup signal if carrier drops. 

—nohang Send hangup signal to control process group when carrier drops. 
etxack Diablo style etx/ack handshaking (not implemented). 


The following special characters are applicable only to the new teletype driver and are not nor- 
mally changed. 


SsuSD C set suspend process character to c (default control Z.) 

dsusp c set delayed suspend process character to c (default control Y.) 
rprnt c — set reprint line character to c (default control R.) 

flush c — set flush output character to c (default control O.) 

werase c set word erase character to c (default control W.) 

Inext c set literal next character to c (default control V.) 


SEE ALSO 
ioct!(2), tabs(1), tset(1), newtty (4), tty (4) 
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NAME 
style — analyze surface characteristics of a document 


SYNOPSIS 
style [ —ml] [—mm] [ ~a] [ ~e] [—-I num] [—rnum] [—pJ] [—P] file ... 


DESCRIPTION 

Style analyzes the surface characteristics of the writing style of a document. It reports on reada- 
bility, sentence length and structure, word length and usage, verb type, and sentence openers. 
Because style runs deroff before looking at the text, formatting header files should be included 
as part of the input. The default macro package ~—ms may be overridden with the flag —-mm. 
The flag ~ml, which causes deroff to skip lists, should be used if the document contains many 
lists of non-sentences. The other options are used to locate sentences with certain characteris- 
tics. 


| print all sentences with their length and readability index. 

—~@e print all sentences that begin with an expletive. 

9 print all sentences that contain a passive verb. 

~Inum print ali sentences longer than num. 

~rnum print all sentences whose readability index is greater than zum. 
=—P print parts of speech of the words in the document. 


SEE ALSO 
deroff(1), diction (1) 


BUGS 
Use of non-standard formatting macros may cauSe incorrect sentence breaks. 
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NAME 
su — substitute user id temporarily 


SYNOPSIS 
su [ userid ] 


DESCRIPTION 
Su demands the password of the specified userid, and if it is given, changes to that userid and 
invokes the Shell sh(1) without changing the current directory. The user environment is 
unchanged except for HOME and SHELL, which are taken from the password file for the user 
being substituted (see environ(5)). The new user ID stays in force until the Shell exits. 


If no userid is specified, ‘root’ is assumed. To remind the super-user of his responsibilities, the 
Shell substitutes ‘#° for its usual prompt. 

SEE ALSO 
sh(1) 

BUGS 
Local administrative rules cause restrictions to be placed on who can su to ‘root’, even with the 
root password. These rules vary from site to site. 
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NAME 
sum — sum and count blocks in a file 


SYNOPSIS 
sum file 

DESCRIPTION 
Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of 
blocks in the file. It is typically used to look for bad spots, or to validate a file communicated 
over some transmission line. 


SEE ALSO 
we(1) 


DIAGNOSTICS 
‘Read error’ is indistinuishable from end of file on most devices; check the block count. 
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NAME 

symorder — rearrange name list 
SYNOPSIS 

symorder orderlist symbolfile 
DESCRIPTION 


Orderlist is a file containing symbols to be found in symbolfile, 1 symbol per line. 


Symbolfile is updated in place to put the requested symbols first in the symbol table, in the 
order specified. This is done by swapping the old symbols tn the required spots with the new 
ones. If all of the order symbols are not found, an error is generated. 


This program was specifically designed to cut down on the overhead of getting symbols from 
/vmunix. | 


SEE ALSO 
nlist(3) 
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NAME 
tabs ~ set terminal tabs 


SYNOPSIS 
tabs [ —n ] [ terminal ] 
DESCRIPTION 
Tabs sets the tabs on a variety of terminals. Various terminal names given in term(7) are 
recognized; the default is, however, suitable for most 300 baud terminals. If the —n flag is 
present then the left margin is not indented as is normal. 
SEE ALSO 
stty (1), term(7) 
BUGS 
7 It’s much better to use sser{1). 
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NAME 
tail — deliver the last part of a file 
SYNOPSIS 
tail [ +number[Ibel [fr] ] [ file ] 
DESCRIPTION 
Tail copies the named file to the standard output beginning at a designated place. If no file is 
named, the standard input is used. 


Copying begins at distance +mumber from the beginning, or —number from the end of the 
input. Number is counted in units of lines, blocks or characters, according to the appended 
option I, b or c. When no units are specified, counting is by lines. 


Specifying r causes tail to print lines from the end of the file in reverse order. The default for r 
is to print the entire file this way. Specifying f causes tai/ to not quit at end of file, but rather 
wait and try to read repeatedly in hopes that the file will grow. 


SEE ALSO 
dd(1) 


BUGS 
Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. 
Various kinds of anomalous behavior may happen with character special files. 
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tar ~ tape archiver 


SYNOPSIS 


tar [key ] [ name... ] 


DESCRIPTION 


Tar saves and restores files on magtape. Its actions are controlled by the key argument. The 
key is a string of characters containing at most one function letter and possibly one or more 
function modifiers. Other arguments to the command are file or directory names specifying 
which files are to be dumped or restored. In all cases, appearance of a directory name refers to 
the files and (recursively) subdirectories of that directory. 


The function portion of the key is specified by one of the following letters: 


r 


x 


P 


The named files are written on the end of the tape. The c function implies this. 


The named files are extracted from the tape. If the named file matches a directory 
whose contents had been written onto the tape, this directory is (recursively) 
extracted. The owner, modification time, and mode are restored (if possible). If no 
file argument is given, the entire content of the tape is extracted. Note that if multiple 
entries specifying the same file are on the tape, the last one overwrites all earlier. 


The names of the specified files are listed each time they occur on the tape. If no file 
argument is given, all of the names on the tape are listed. 


The named files are added to the tape if either they are not already there or have been 
modified since last put on the tape. 


Create a new tape, writing begins on the beginning of the tape instead of after the last 
file. This command implies r. 


On output, tar normally places information specifying owner and modes of directories 
in the archive. Former versions of tar, when encountering this information will give 
error message of the form 

"<name>/: cannot create”. 
This option will suppress the directory information. 


This option says io restore files to their original modes, ignoring the present umask (2). 
Setuid and sticky information will also be restored to the super-user. 


The following characters may be used in addition to the letter which selects the function 


desired. 
0,...,/ 


This modifier selects an alternate drive on which the tape is mounted. (The default 
is drive 0 at 1600 bpi, which is normally /dev/rmt8.) 


Normally tar does its work silently. The v (verbose) option causes it to type the 
name of each file it treats preceded by the function letter. With the t function, v 
gives more information about the tape entries than just the name. 


causes far to print the action to be taken followed by file name, then wait for user 
confirmation. If a word beginning with ‘y’ is given, the action is performed. Any 
other input means don’t do it. 


causes var to use the next argument as the name of the archive instead of 
/dev/rmt?. If the name of the file is ‘—’, tar writes to standard output or reads from 
standard input, whichever is appropriate. Thus, sarcan be used as the head or tail of 
a filter chain 7arcan also be used to move hierarchies with the command 

cd fromdir; tar cf - . | (cd todir; tar xf -) 


causes iar to use the next argument as the blocking factor for tape records. The 
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default is 20 (the maximum). This option should only be used with raw magnetic 
tape archives (See f above). The block size is determined automatically when read- 
ing tapes (key letters ‘x’ and ‘t’). 


l tells tar to complain if it cannot resolve all of the links to the files dumped. If this is 
not specified, no error messages are printed. 
m tells tar to not restore the modification times. The mod time will be the time of 
extraction. 
Previous restrictions dealing with sar’s inability to properly handle blocked archives have been 
lifted. 
FILES 
/dev/rmt? 
/tmp/tare 
DIAGNOSTICS 


Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 


BUGS 
There is no way to ask for the wth occurrence of a file. 
Tape errors are handled ungracefully. 
The u option can be slow. 
The current limit on file name length is 100 characters. 


1-243 
4th Berkeley Distribution 4/1/81 


TBL (1) 


NAME 


tbl — format tables for nroff or troff 


SYNOPSIS 


UNIX Programmer’s Manual 


tbl [ files } ... 


DESCRIPTION 


TBL (1) 


Tb/ is a preprocessor for formatting tables for nroffor troff(1). The input files are copied to the 
standard output, except for lines between .TS and .TE command lines, which are assumed to 


describe tables and reformatted. Details are given in the reference manual. 


As an example, letting \t represent a tab (which should be typed as a genuine tab) the input 


yields 


.TS 

css 

ccs 

c¢ce 

Inn. 

Household Population 
Town\tHouseholds 
\tNumber\tSize 
Bedminster\t789\t3.26 
Bernards Twp.\t3087\t3.74 
Bernardsville\t2018\t3.30 
Bound Brook\t3425\t3.04 
Branchburg\t1644\t3.49 
Bridgewater\t7897\t3.81 
Far Hills\t240\t3.19 

ae 


Household Population 


Town Households 

Number Size 
Bedminster 789 3.26 
Bernards Twp. 3087 3.74 
Bernardsville 2018 3.30 
Bound Brook 3425 3.04 
Branchburg 1644 3.49 
Bridgewater 7897 3.81 
Far Hills 240 3.19 


If no arguments are given, d/ reads the standard input, so it may be used as a filter. When it is 
used with egn or neqn the tb/ command should be first, to minimize the volume of data passed 
through pipes. 


SEE ALSO 


troff(1), eqn(1) 
M. E. Lesk, T&L. 
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NAME 
tc — photypesetter simulator 

SYNOPSIS 

te{—t] [—sN][—pL ] [ file ] 

DESCRIPTION 
Tc interprets its input (standard input default) as device codes for a Graphic Systems photo- 
typesetter (cat). The standard output of tc is intended for a Tektronix 4015 (a 4014 teminal 
with ASCII and APL character sets). The sixteen typesetter sizes are mapped into the 4014’s 


four sizes; the entire TROFF character set is drawn using the 4014’s character generator, using 
overstruck combinations where necessary. Typical usage: 


troff —t file | tc 
At the end of each page tc waits for a newline (empty line) from the keyboard before continu- 


ing on to the next page. In this wait state, the command e will suppress the screen erase before 


the next page; sN will cause the next N pages to be skipped; and !line will send line to the 
shell. 


The command line options are: 


—t Don’t wait between pages; for directing output into a file. 
—sN_ Skip the first N pages. 
—pl Set page length to L. L may include the scale factors p (points), i (inches), ¢ (centime- 
ters), and P (picas); default is picas. 
Multiply the default aspect ratio, 1.5, of a displayed page by //w. 
SEE ALSO 
troff(1), plot(1) 
BUGS 
Font distinctions are lost. 


tc’s character set is limited to ASCII in just one size. 
The aspect ratio option is unbelievable. 
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NAME 

tee — pipe fitting 
SYNOPSIS = 

ee [i] [—a] [ file) ... 
DESCRIPTION 


Tee transcribes the standard input to the standard output and makes copies in the files. Option 
—i ignores interrupts; option ~a causes the output to be appended to the files rather than 
overwriting them. 
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NAME 
test — condition command 


SYNOPSIS 
test expr 


DESCRIPTION 


fest evaluates the expression expr, and if its value is true then returns zero exit status; other- 
wise, a non zero exit status is returned. fest returns a non zero exit if there are no arguments. 


The following primitives are used to construct expr. 

—rfile true if the file exists and is readable. 

—w file true if the file exists and is writable. 

—f file true if the file exists and is not a directory. 

—dfile true if the file exists exists and is a directory. 

—s file true if the file exists and has a size greater than zero. 
—t [ fildes } 


true if the open file whose file descriptor number is fildes (1 by default) is associated 
with a terminal device. 


~—Z Si true if the length of string sJ is zero. 

—~nsl_ true if the length of the string s/ is nonzero. 
sl] = s2 true if the strings si and s2 are equal. — 

sl '== s2 true if the strings s/ and s2 are not equal. 

s] true if s/ is not the null string. 

ni eq n2 


true if the integers nl and n2 are algebraically equal. Any of the comparisons —ne, 
gt, —ge, —It, or ~le may be used in place of —eq. 


These primaries may be combined with the following operators: 
! unary negation operator 

—a binary and operator 

—© binary or operator 


( expr ) 
parentheses for grouping. 


—a has higher precedence than —o. Notice that all the operators and flags are separate argu- 
ments to test. Notice also that parentheses are meaningful to the Shell and must be escaped. 


SEE ALSO 
sh(1), find(1) 
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NAME 
time — time a command 


SYNOPSIS 
time command 


DESCRIPTION 
The given command is executed; after it is complete, time prints the elapsed time during the 
command, the time spent in the system, and the time spent in execution of the command. 
Times are reported in seconds. 


On a PDP-11, the execution time can depend on what kind of memory the program happens to 
land in; the user time in MOS is often half what it is in core. 
The times are printed on the diagnostic output stream. 


BUGS 
Elapsed time is accurate to the second, while the CPU times are measured to the 60th second. 
Thus the sum of the CPU times can be up to a second larger than the elapsed time. 


Time is a built-in command to csh(1), with a much different syntax. This command is available 
as ‘‘/bin/time’’ to cs users. 
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NAME 

tk — paginator for the Tektronix 4014 
SYNOPSIS 

tk{—t])[—N] [—pZ] [ file] 
DESCRIPTION 


The output of tk is intended for a Tektronix 4014 terminal. 7k arranges for 66 lines to fit on 
the screen, divides the screen into N columns, and contributes an eight space page offset in the 
(default) single-column case. Tabs, spaces, and backspaces are collected and plotted when 
necessary. Teletype Model 37 half- and reverse-line sequences are interpreted and plotted. At 
the end of each page tk waits for a newline (empty line) from the keyboard before continuing 


on to the next page. In this wait state, the command !command will send the command to the 
shell. 


The command line options are: 

— t Don’t wait between pages; for directing output into a file. 

-N Divide the screen into N columns and wait after the last column. 
—~pl Set page length to Z lines. 


SEE ALSO 
pr(1) 
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NAME ~ 
touch — update date last modified of a file 
SYNOPSIS 
touch [ —c ] file ... 
DESCRIPTION 
Touch attempts to set the modified date of each file. This is done by reading a character from 
the file and writing it back. 
If a file does not exist, an atternpt will be made to create it unless the —ec option is specified. 
SEE ALSO 
sy utime(2) 


eee 
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NAME 


SYNOPSIS 


UNIX Programmer’s Manual TP{1) 


tp — manipulate tape archive 


tp [key ] [ name... ] 


DESCRIPTION 


Tp saves and restores files on DECtape or magtape. Its actions are controlled by the key argu- 
ment. The key Is a string of characters containing at most one function letter and possibly one 
or more function modifiers. Other arguments to the command are file or directory names 

specifying which files are to be dumped, restored, or listed. In all cases, appearance of a direc- 
tory name refers to the files and (recursively) subdirectories of that directory. 


The function portion of the key is specified by one of the following letters: 


¥ 


The named files are written on the tape. If files with the same names already exist, 
they are replaced. ‘Same’ is determined by string comparison, so ‘./abc’ can never be 
the same as ‘/usr/dmr/abc’ even if ‘/usr/dmr’ is the current directory. If no file argu- 
ment is given, ‘.’ is the default. 


updates the tape. uw is like r, but a file is replaced only if its modification date ts later 
than the date stored on the tape; that is to say, if it has changed since it was dumped. 
u is the default command if none is given. 


deletes the named files from the tape. At least one name argument must be given. 
This function is not permitted on magtapes. 


extracts the named files from the tape to the file system. The owner and mode are 
restored. If no file argument is given, the entire contents of the tape are extracted. 


lists the names of the specified files. If no file argument is given, the entire contents 
of the tape is listed. 


The following characters may be used in addition to the letter which selects the function 


desired. 
m 
Oecd, 


Specifies magtape as opposed to DECtape. 


This modifier selects the drive on which the tape is mounted. For DECtape, x is 
default; for magtape ‘0’ is the default. 


Normally sp does its work silently. The v (verbose) option causes it to type the 
name of each file it treats preceded by the function letter. With the t function, v 
gives more information about the tape entries than just the name. 


means a fresh dump is being created; the tape directory is cleared before beginning. 
Usable only with r and u. This option is assumed with magtape since it is impossible 
to selectively overwrite magtape. 


Errors reading and writing the tape are noted, but no action is taken. Normally, 
errors cause a return to the command level. 


Use the first named file, rather than a tape, as the archive. This option currently 
acts like m; i.e. r implies c, and neither d nor u are permitted. | 


causes tp to pause before treating each file, type the indicative letter and the file 
name (as with v) and await the user’s response. Response y means ‘yes’, so the file 
is treated. Null response means ‘no’, and the file does not take part in whatever is 
being done. Response x means ‘exit’; the ¢p command terminates immediately. In 
the x function, files previously asked about have been extracted already. With r, u, 
and d no change has been made to the tape. | 
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FILES 
/dev/tap? 
/dev/rmt? 


SEE ALSO 
ar(1), tar(1) 


DIAGNOSTICS 
Several; the non-obvious one is ‘Phase error’, which means the file changed after it was 
selected for dumping but before it was dumped. 


BUGS 
A single file with several links to it is treated like several files. 


Binary-coded control information makes magnetic tapes written by ¢p difficult to carry to other 
machines; tar(1) avoids the problem. 
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NAME 
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tr — translate characters 


SYNOPSIS 


tr { —cds ] [ string! [ string2 ]:]. 


DESCRIPTION 


Tr copies the standard input to the standard output with substitution or deletion of selected 
characters. Input characters found in string] are mapped into the corresponding characters of 
string2. When string2 is short it is padded to the length of string] by duplicating its last charac- 
ter. Any combination of the options —cds may be used: —c complements the set of characters 
in string] with respect to the universe of characters whose ASCII codes are 01 through 0377 
octal; —d deletes all input characters in string]; ms squeezes all strings of repeated output char- 
acters that are in string2 to single characters. 


In either string the notation a—b means a range of characters from a to bin increasing ASCII 
order. The character ‘\’ followed by 1, 2 or 3 octal digits stands for the character whose ASCII 
code is given by those digits. A ‘\’ followed by any other character stands for that character. 


The following example creates a list of all the words in ‘filel’ one per line in ‘file2’, where a 
word is taken to be a maximal string of alphabetics. The second string is quoted to protect ‘\’ 
from the Shell. 012 is the ASCII code for newline. 


tr —cs A—Za—z ‘\012’ <filel >file2 


SEE ALSO 


BUGS 


ed(1), ascii(7) 


Won’t handle ASCII NUL in string] or string2; always deletes NUL from input. 
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NAME 

trman — translate version 6 manual macros to version 7 macros 
SYNOPSIS | 

trman [ file ] 
DESCRIPTION 


_Trman reads the input file, which should be nroff/troff input and attempts to translate the ver- 
sion 6 manual sections therein to version 7 format. It is largely successful, but seems to have 
trouble with indented paragraphs and complicated font control. You should expect to have to 
fix up long sections by hand somewhat. 


SEE ALSO 
man(7) 


BUGS 
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NAME 
troff, nroff — text formatting and typesetting 
SYNOPSIS 
troff [ option] ... { file] ... 
nroff {[ option]... [ file] ... 
DESCRIPTION | 
Troff formats text in the named fies for printing on a Graphic Systems C/A/T phototypesetter; 
nroff for typewriter-like devices. Their capabilities are described in the NroffTroff user’s manual. 


If no file argument is present, the standard input is read. An argument consisting of a single 
minus (—) is taken to be a file name corresponding to the standard input. The options, which 
may appear in any order so long as they appear before the files, are: 


—olist Print only pages whose page numbers appear in the comma-separated list of numbers 
and ranges. A range N—M means pages N through M, an initial —N means from 
the beginning to page N; and a final Y— means from MN to the end. 


~nN Number first generated page N. 


—sN Stop every NV pages. Nroff will halt prior to every N pages (default W=1) to allow 
paper loading or changing, and will resume upon receipt of a newline. TJroff will stop 
the phototypesetter every NV pages, produce a trailer to allow changing cassettes, and 
resume when the typesetter’s start button is pressed. 


—maname Prepend the macro file /usr/lib/tmac/tmac. name to the input fies. 
—raN Set register a (one-character) to N. 


4 Read standard input after the input files are exhausted. 
—q Invoke the simultaneous input-output mode of the rd request. 
Nroff only 


—Tzname Prepare output for specified terminal. Known names are 37 for the (default) Tele- 
type Corporation Model 37 terminal, tn300 for the GE TermiNet 300 (or any termi- 
nal without half-line capability), 300S for the DASI-300S, 300 for the DASI-300, and 
450 for the DASI-450 (Diablo Hyterm). 


—@ Produce equally-spaced words in adjusted lines, using full terminal resolution. 

=i Use output tabs during horizontal spacing to speed output and reduce output charac- 
ter count. Tab settings are assumed to be every 8 nominal character widths. 

Troff only 

—t Direct output to the standard output instead of the phototypesetter. 

— f Refrain from feeding out paper and stopping phototypesetter at the end of the run. 

— W Wait until phototypesetter is available, uf currently busy. 

—b Report whether the phototypesetter is busy or available. No text processing is done. 

= 3 ’ Send a printable ASCII approximation of the results to the standard output. 

~pN Print all characters in point size N while retaining all prescribed spacings and 
motions, to reduce phototypesetter elasped time. 

—Z Prepare output for a GCOS phototypesetter and direct it to the standard output (see 


gcat(l)). 


If the file /usr/admitracct is writable, trof’ keeps phototypesetter accounting records there. The 
integrity of that file may be secured by making troffa ‘set user-id’ program. 
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FILES 
/usr/lib/suftab suffix hyphenation tables 
/tmp/tas temporary file 
/usr/lib/tmac/tmac.* standard macro files 
/usr/lib/term/s terminal driving tables for nroff 
/usr/lib/font/« font width tables for rroff 
/dev/cat phototypesetter 
/usr/adm/tracct accounting statistics for /dev/cat 
SEE ALSO 


J. F. Ossanna, Nroff/Troff user's manual 

B. W. Kernighan, A TROFF Tutorial 

viroff(1), eqn(1), tbi(1), pti(1), ms(7), me(7), man(7), soelim(1) 
col(1), tk(1) (uroff only) 

tc(1) (rroff only) 


1-256 


7th Fditinn 


TRUE (1) | UNIX Programmer’s Manual TRUE (1) 


NAME 
true, false = provide truth values 


SYNOPSIS 
true 
false 


DESCRIPTION 


True does nothing, successfully. False does nothing, unsuccessfully. They are typically used in 
input to sh(1) such as: 


while true 
do 
command 
done 
SEE ALSO 
sh(1) 
DIAGNOSTICS 


True has exit status zero, false nonzero. 
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NAME 


tset — set terminal modes 


SYNOPSIS 


tset [ options ] [ —m [idend{sest baudrate}: ype... | [ type } 


DESCRIPTION 


Tset causes terminal dependent processing such as setting erase and kill characters, setting or 
resetting delays, and the like. [t first determines the spe of terminal involved, names for which 
are specified by the /eic/ermcap data base, and then does necessary initializations and mode set- 
tings. In the case where no argument types are specified, tsersimply reads the terminal type out | 
of the environment variable TERM and re-initializes the terminal. The rest of this manual con- 
cerns itself with type initialization, done typically once at login, and options used at initialization 
time to determine the terminal type and set up terminal modes. 


When used in a startup script .profile (for sh{1) users) or .login (for csh(1) users) it is desirable 
to give information about the types of terminal usually used on terminals which are not 
hardwired. These ports are initially identified as being dialup or plugboard or arpanet etc. To 
specify what terminal type is usuaily used on these ports —m is followed by the appropriate 
port type identifier, an optional baud-rate specification, and the terminal type to be used if the 
mapping conditions are satisfied. If more than one mapping is specified, the first applicable 
mapping prevails. A missing type identifier matches all identifiers. 


Baud rates are specified as with s¢ty(1), and are compared with the speed of the diagnostic out- 
put (which is almost always the control terminal). The baud rate test may be any combination 
of: >, =, <, @, and !; @ is a synonym for ™ and ! inverts the sense of the test. To avoid 
problems with metacharacters, it is best to place the entire argument to —m within ‘*’’’ charac- 
ters; users of csh(1) must also put a ‘‘\’’ before any ‘‘!’’ used here. 


Thus 
tset —m ‘dialup>300:adm3a° —m dialup:dw2 —m ‘plugboard:?adm3a’ 


causes the terminal type to be set to an adm3a if the port in use is a dialup at a speed greater 
than 300 baud: to a dwJif the port is (otherwise) a dialup (i.e. at 300 baud or less). If the spe 
above begins with a question mark, the user is asked if s/he really wants that type. A null 
response means to use that type; otherwise, another type can be entered which will be used 
instead. Thus, in this case, the user will be queried on a plugboard port as to whether they are 
using an adm3a. For other ports the port type will be taken from the /etc/ttytype file or a final, 
default ppe option may be given on the command line not preceded by a ~m. 


It is often desirable to return the terminal type, as specified by the —m options, and informa- 
tion about the terminal to a shell’s environment. This can be done using the —s option; using 
the Bourne shell, sA(1): 


eval ‘tset —s options... 
or using the C shell, csa(1): 
set noglob; eval ‘tset —s options... 


These commands cause ¢sef to generate as output a sequence of shell commands which place 
the variables TERM and TERMCAP in the environment; see environ(5). 


Once the terminal type is known, tserengages in terminal mode setting. This normally involves 
sending an initialization sequence to the terminal and setting the single character erase (and 
optionally the line-kill (full line erase)) characters. 


On terminals that can backspace but not overstrike (such as a CRT), and when the erase charac- 
ter is the default erase character (‘#° on standard systems), the erase character is changed to a 


Control-H (backspace). 
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The options are: 
—@ set the erase character to be the named character con all terminals, the default being 
the backspace character on the terminal, usually “H. 


is similar to ~e but for the line kill character rather than the erase character, c defaults 


to “X (for purely historical reasons); “U is the preferred setting. No kill processing is 
done if —k is not specified. 


~—I _ supresses outputting terminal initialization strings. 
-Q __supresses printing the ‘Erase set to’’ and ‘‘Kill set to’’ messages. 


-§ Outputs the strings to be assigned to TERM and TERMCATP in the environment rather 
than commands for a shell. 


FILES | 
/etc/ttytype terminal id to type map database 
/etc/termcap terminal capability database 
SEE ALSO 
esh(1), setenv(1), sh(1), stty(1), environ(5), ttytype(5), termcap(5) 
AUTHOR 
Eric Allman 
BUGS 
Should be merged with szy(1). 
NOTES 
For compatibility with earlier versions of sser a number of flags are accepted whose use is 
discouraged: 


—dtype equivalent to —m dialup:type 
—ptype equivalent to —m plugboard:type 
~atype equivalent to —m arpanet:type 


-Ec Sets the erase character to conly if the terminal can backspace. 
_ prints the terminal type on the standard output 
all | prints the terminal type on the diagnostic output. 


1-259 
4th Berkeley Distribution 4/1/81 


TSORT (1) UNIX Programmer’s Manual TSORT (1) 


NAME 
tsort — topological sort 


SYNOPSIS 
tsort [ file ] 


DESCRIPTION 
Tsort produces on the standard output a totally ordered list of items consistent with a partial 
ordering of items mentioned in the input file. If no file is specified, the standard input is 
understood. 
The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different 
items indicate ordering. Pairs of identical items indicate presence, but not ordering. 


SEE ALSO 
lorder(1) 


DIAGNOSTICS 
Odd data: there is an odd number of fields in the input file. 


BUGS 
Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 
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NAME 
tty — get terminal name 


SYNOPSIS 
tty 


DESCRIPTION 
Tty prints the pathname of the user’s terminal. 


DIAGNOSTICS 
‘not a tty’ if the standard input file is not a terminal. 
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NAME 
ul — do underlining 
SYNOPSIS 
ul [ —i] [ —t terminal) [ name... | 


DESCRIPTION 
| Ul reads the named files (or standard input if none are given) and translates occurances of 


underscores to the sequence which indicates underlining for the terminal in use, as specified by 
the environment variable TERM. The —t option overrides the terminal kind specified in the 
environment. The file /erc/termcap is read to determine the appropriate sequences for underlin- 
ing. If the terminal is incapable of underlining, but is capable of a standout mode then that is 
used instead. If the terminal can overstrike, or handles underlining automatically, u/ degen- 
erates to caf(1). If the terminal cannot underline, underlining is ignored. 


The -i option causes uw/ to indicate underlining onto by a separate line containing appropriate 
dashes ‘—’; this is useful when you want to look at the underlining which is present in an nroff 
output stream on a crt-terminal. 


SEE ALSO 
man(1), nroff(1), colert(1) 


AUTHOR 
Mark Horton wrote wi; the —i option was originally a option of the editor ex, then a jul com- 


mand. 

BUGS 

bs Nroff usually outputs a series of backspaces and underlines intermixed with the text to indicate 
underlining. No attempt is made to optimize the backward motion. 
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NAME 

uniq — report repeated lines in a file 
SYNOPSIS 

uniq [ ~ude [+n] [ —n J) [input [ output ] ] 
DESCRIPTION 


Unig reads the input file comparing adjacent lines. In the normal case, the second and succeed- 
ing copies of repeated lines are removed; the remainder is written on the output file. Note that 
repeated lines must be adjacent in order to be found; see sorr({1). If the —uw flag is used, just 
the lines that are not repeated in the original file are output. The —d option specifies that one 


copy of just the repeated lines is to be written. The normal mode output is the union of the 
—u and —d mode outputs. 


The —c option supersedes ~u and —d and generates an output report in default style but with 
each line preceded by a count of the number of times it occurred. 


The nm arguments specify skipping an initial portion of each line in the comparison: 


nN The first  flelds together with any blanks before each are ignored. A field is defined 


as a string of non-space, non-tab characters separated by tabs and spaces from its 
neighbors. 


+n The first » characters are ignored. Fields are skipped before characters. 


SEE ALSO 
sort(1), comm(]) 
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NAME 


units — conversion program 


SYNOPSIS 


units 


DESCRIPTION 


FILES 


BUGS 


Units converts quantities expressed in various standard scales to their equivalents in other 
scales. It works interactively in this fashion: 


You have: inch 

You want: cm 
© 2.54000e + 00 
/ 3.9370le—01 


A quantity is specified as a multiplicative combination of units optionally preceded by a numeric 
multiplier. Powers are indicated by suffixed positive integers, division by the usual sign: 


You have: 1§ pounds force/in2 
You want: atm 

* 1.0206 9e +00 

/ 9.79730e—01 


Units only does multiplicative scale changes. Thus it can convert Kelvin to Rankine, but not 
Centigrade to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recog- 
nized, together with a generous leavening of exotica and a few constants of nature including: 


pi ratio of circumference to diameter 
c speed of light 

e charge on an electron 

g acceleration of gravity 


force same as g 

mole Avogadro’s number: 

water pressure head per unit height of water 
au astronomical unit 


‘Pound’ is a unit of mass. Compound names are run together, e.g. ‘lightyear’. British units 
that differ from their US counterparts are prefixed thus: ‘brgallon’. Currency is denoted ‘beligi- 
umfranc’, ‘britainpound’, ... 

For a complete list of units, ‘cat /usr/lib/units’. 


/usr/lib/units 


Don’t base your financial plans on the currency conversions. 
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NAME 
uptime — show how long system has been up 


SYNOPSIS 
uptime 


DESCRIPTION 
Uptime prints the current time, the length of time the system has been up, and the average 
number of jobs in the run queue over the last 1, 5 and 15 minutes. It is, essentially, the first 
line of a w (1) command. 


FILES 
/vmunix system name list 


SEE ALSO 
w(1) 
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NAME 
users — compact list of users who are on the system 


SYNOPSIS 
users 


DESCRIPTION 
Users lists the login names of the users currently on the system in a compact, one-line format. 


FILES 
/etc/utmp | 


SEE ALSO 
finger(1), who(1) 


BUGS 
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NAME 


uuclean — uucp spool directory clean-up 


SYNOPSIS 


uuclean [ option } ... 


DESCRIPTION 


Uuclean will scan the spool directory for files with the specified prefix and delete all those which 
are older than the specified number of hours. 


The following options are available. 


—ppre Scan for files with pre as the file prefix. Up to 10 —p arguments may be specified. A 
—p without any pre following will cause all files older than the specified time to be 
deleted. 


—ntime Files whose age is more than time hours will be deleted if the prefix test is satisfied. 
(default time is 72 hours) 


—m Send mail to the owner of the file when it is deleted. 
This program will typically be started by cron(8). 


FILES 
/usr/lib/uucp directory with commands used by uuclean internally 
/usr/lib/uucp/spool spool directory 

SEE ALSO 


uucp(1C), uux(1C) 
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NAME 
uucp, uulog —- unix to unix copy 


SYNOPSIS 
uucp [ option ] ... source-file ... destination-file 


uulog [ option } ... 


DESCRIPTION 
Uucp copies files named by the source-file arguments to the destination-file argument. A file 
name may be a path name on your machine, or may have the form 


system-name'pathname 


where ‘system-name’ is taken from a list of system names which wucp knows about. Shell 
metacharacters ?*{] appearing in the pathname part will be expanded on the appropriate systern. 


Pathnames may be one of 
(1) a full pathname; 


(2) a pathname preceded by “user, where user is a userid on the specified system and is 
replaced by that user’s login directory; 


(3) anything else is prefixed by the current directory. 


If the result is an erroneous pathname for the remote system the copy will fail. If the 
destination-file is a directory, the last part of the source-file name is used. 


Uucp preserves execute permissions across the transmission and gives 0666 read and write per- 
missions (see chmod(2)). 


The following options are interpreted by uucp. 

—d Make ail necessary directories for the file copy. 

=< Use the source file when copying out rather than copying the file to the spool directory. 
—m Send mail to the requester when the copy is complete. 


Uulog maintains a summary log of uuwcp and uux(l) transactions in the file 
‘/usr/spool/uucp/LOGFILE’” by gathering information from partial log files named 
‘/usr/spool/uucp/LOG.*.?*. It removes the partial log files. 


The options cause uwu/og to print logging information: 
—ssys Print information about work involving system sys. 


—uuser 
Print information about work done for the specified user. 


FILES 
/usr/spool/uucp - spool directory 
/ust/lib/uucp/* - other data and program files 
SEE ALSO 
uux(1), mail(1) 
D. A. Nowitz, Uucp Implementation Description 
WARNING 
The domain of remotely accessible files can (and for obvious security reasons, usually should) 
be severely restricted. You will very likely not be able to fetch files by pathname; ask a respon- 


sible person on the remote system to send them to you. For the same reasons you will prob- 
ably not be able to send files to arbitrary pathnarmes. 
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BUGS 
All files received by wucp will be owned by uucp. 
The —m option will only work sending files or receiving a single file. (Receiving multiple files 
specified by special shell characters ?*{] will not activate the —m option.) 


1-269 


UUDIFF( IC) | UNIX Programmer's Manual UUDIFF (1C) 


uudilf — directory comparison between machines 


SYNOPSIS 


FILES 


uudiff [ ~—d ] local-name remote-name 


Uudiff compares the files in the directory local-name and the directory remote-name, (where 
remote-name may be of the form system-name!directory-name and system-name is a wucp Unix 
name). It reports (via mail) which files are added, deleted, or changed, and provides a dif) 
of altered printable files. | 


If a part of remote-name is omitted (either the system or the directory) the corresponding part 
of local-name is used. If local-name is a file, rather than a directory, remote-name is also 
assumed to be a file and the program degenerates into dif(L). 


The option --d does not diff altered files; only the summary by file names is prepared. 


SEE ALSO 


diff(1), uucp(1) 


DIAGNOSTICS 


BUGS 


Almost none. Anything more serious than misspelling /ocal-name causes unpredictable and 
obscure results. 


In addition to the standard uucp requirements a hook is needed at the remote system, and at 
present is only installed on the systems “research” and “inter”. 

This program is written in shell and shouid be translated to C so it could give diagnostics. 

Even if “remote-system” is the local system, uudiff is subject to delays in uucp traffic. 

It should probably write the standard output, instead of insisting on going into the background. 
Since checksums are used there is a probability of 1 in 2°*°32 of missing differences between 
files. 

The “userid syntax is not recognized. 
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NAME 
uuencode,uudecode — encode/decode a binary file for tranmission via mail 

SYNOPSIS 
uuencode [ source ] remotedest | mail sys1!sys2!..'decode 
uudecode [ file | 

DESCRIPTION 7 
Uuencode and uudecode are used to send a binary file via uucp (or other) mail. This combina- 
tion can be used over indirect mail links even when uwusend(/) is not available. 
Uuencode takes the named source file (default standard input) and produces an encoded version 
on the standard output. The encoding uses only printing ASCII characters, and includes the 
mode of the file and the remotedest for recreation on the remote system. 
Uudecode reads an encoded file, strips off any leading and trailing lines added by mailers, and 
recreates the original file with the specified mode and name. 
The intent is that all mail to the user ‘‘decode’’ should be filtered through the uudecode pro- 
gram. This way the file is created automatically without human intervention. This 1s possible 
on the uucp network by either using delivermail or by making rmail be a link to Mail instead of 
mai. In each case, an alias must be created in a master file to get the automatic invocation of 
uudecode. 
If these facilities are not available, the file can be sent to a user on the remote machine who 
can uudecode it manually. 
The encode file has an ordinary text form and can be edited by any text editor to change the 
mode or remote name. 

SEE ALSO 
uuencode(5), uusend(1), uucp(1), uux(]), mail() 

AUTHOR 
Mark Horton 

BUGS 


The file is expanded by 35% (3 bytes become 4 plus control information) causing it to take 
longer to transmit. 


The user on the remote system who is invoking wudecode (often uucp) must have write permis- 
sion on the specified file. 
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NAME 

uusend — send a file to a remote host 
SYNOPSIS | 

uusend { —m mode | sourcefile sysl!sys2!..!remotefile 
DESCRIPTION 


Uusend sends a file to a given location on a remote system. The system need not be directly 
connected to the local system, but a chain of uucp(J) links needs to connect the two systems. 


If the ~m option is specified, the mode of the file on the remote end will be taken from the 
octal number given. Otherwise, the mode of the input file will be used. 


The sourcefile can be ‘*—’’, meaning to use the standard input. Both of these options are pri- 
marily intended for internal use of uusend. 
The remotefile can include the “userid syntax. 

DIAGNOSTICS 
If anything goes wrong any further away than the first system down the line, you will never 
hear about it. : 


SEE ALSO 
uux(1), uucp(1), uuencode (1) 


AUTHOR 

Mark Horton 
BUGS 
| This command shouldn’t exist, since wucp should handle it. 
All systems along the line must have the wusend command available and allow remote execu- 
tion of it. | | 
Some uucp systems have a bug where binary files cannot be the input to a uux command. If 
this bug exists in any system along the line, the file will show up severly munged. 
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NAME 


wuuxX —™ unix to unix command execution 


SYNOPSIS 


uux { — ) command-string 


DESCRIPTION 


FILES 


Uux will gather 0 or more files from various systems, execute a command on a specified system 
and send standard output to a file on a specified system. 


The command-string is made up of one or more arguments that look like a shell command line, 
except that the command and file names may be prefixed by system-name!. A null system- 
mame is interpreted as the local system. 


File names may be one of 
(1) a full pathname; 


(2) a pathname preceded by “20x; where ocx is a userid on the specified system and is 
replaced by that user’s login directory; 


(3) anything else is prefixed by the current directory. 


The ‘—’ option will cause the standard input to the wux command to be the standard input to 
the command-string. 


For example, the command 
uux "!diff usg!/usr/dan/fl pwba!/a4/dan/fl > !fi.diff? 


will get the f1 files from the usg and pwba machines, execute a aiff command and put the 
results in f1.diff in the local directory. 


Any special shell characters such as <>7| should be quoted either by quoting the entire 


command-string, or quoting the special characters as individual arguments. 


/usr/uucp/spool - spool directory 
/usr/uucp/* - other data and programs 


SEE ALSO 


uucp(1) 
D. A. Nowitz, Uucp implementation description 


WARNING 


BUGS 


An installation may, and for security reasons generally will, limit the list of commands execut- 
able on behalf of an incoming request from wux. Typically, a restricted site will permit little 
other than the receipt of mail via ute. 


Only the first command of a shell pipeline may have a system-name!. All other commands are 
executed on the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. 

The shell tokens << and >> are not implemented. 

There is no notification of denial of execution on the remote machine. 
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NAME 

vfontinfo — inspect and print out information about unix fonts 
SYNOPSIS 

vfontinfo [ -v ] fontname [ characters ] 
DESCRIPTION 


Vfontinfo allows you to examine a font in the unix format. It prints out all the information in 
the font header and information about every non-null (width > 0) glyph. This can be used to 
make sure the font is consistent with the format. 


The foniname argument is the name of the font you wish to inspect. It writes to standard out- 
put. If it can’t find the file in your working directory, it looks in /usr/lib/vfont (the place most 
of the fonts are kept). 


The characters, if given, specify certain characters to show. If omitted, the entire font is 
shown. 


If the —v (verbose) flag is used, the bits of the glyph itself are shown as an array of X’s and 
spaces, in addition to the header information. 
SEE ALSO 
vpr(1), vfont(S) 
The Berkeley Font Catalog 


AUTHORS 
Mark Horton 
Andy Hertzfeld 
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vgrind — grind nice listings of programs 


SYNOPSIS 


verind{ ~¢][—nJ] {-x}][-W][—-c] [-m][—-—p] [—-1] [ —sn] { —b header ] name 


DESCRIPTION 


Vgerind formats the C, MODEL, or PASCAL programs which are arguments in a nice style 
using goff (1). Comments are placed in italics, keywords in bold face, and the name of the 
current function is listed down the margin of each page as it is encountered. 


The —W option sends the output to a 4 page wide raster plotter; normally, the output is printed 
on a narrow plotter. 


The —-c, ~m, —p, and —{ options select C, MODEL, PASCAL or ISP respectively as the 
language of the input files. The —e switch is the default and need not be specified. 


Font size may be specified using the —s switch. The argument on is the point size (same as the 
argument of a .ps troff command). 


The —h option specifies a header to be placed at the top of each page. If the program is not 
source, but should be framed like the output of vgrind, the —n option should be specified. 


The —t option is analogous to the —t option of woffll) placing typesetter codes on the stan- 
dard output. 


To create an index, it is only necessary to create an empty file index in the current directory. 
As you run vgrind, the index will be automatically kept up to date. The index of function 


definitions can then be run off via giving vgrindthe —x option and the file index as argument. 
FILES 
index file where source for index is created 
/usr/lib/tmac/tmac.vgrind macro package 
fusr/lib/vfontedpr preprocessor 
AUTHOR 
William Joy 
SEE ALS 
BUGS 


Vfontedpr assumes that a certain programming style is followed: 


For C - functions begin with the name of the function in column one, and lines defining func- 
tions end with a ). The function name is followed immediately by a ‘°C’ with no intervening 
space. 


For PASCAL - function names need to appear on the same line as the keywords function and 
procedure. The keyword end at the beginning of a line is interpreted as the end of the current 
function. 


For MODEL - function names need to appear on the same line as the keywords is beginproc. 


If these conventions are not followed, the indexing and marginal function name comment 
mechanisms will fail. 


More generally, arbitrary formatting styles for programs mostly look bad. The use of spaces to 
ign source code fails miserably; if you plan to vgrind your program you should use tabs. This 
ewhat inevitable since the font used by vgrindis variable width. 
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Should be able to be used as a preprocessor 
The mechanism of ctags in recognizing functions should be used here. 
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NAME 

vi — screen onented (visual) display editor based on ex 
SYNOPSIS 

vi [ —t tag] [ —r] [ +command] [ ~1] [ —wa] name... 
DESCRIPTION 


Vi (visual) is a display oriented text editor based on ex(1). Ex and vi run the same code: it is 
possible to get to the command mode of ex from within wand vice-versa. 


The Vi Quick Reference card and the Introduction to Display Editing with Vi provide full details on 
using vi. 
FILES 
See ex(1). 
SEE ALSO 
ex (1), edit (1), ‘Wi Quick Reference” card, ‘‘An Introduction to Display Editing with Vi". 
AUTHOR 
William Joy 
Mark Horton added macros to visual mode and is maintaining version 3 
BUGS | 
Software tabs using “T work only immediately after the auroindent, 


Left and right shifts on intelligent terminals don’t make use of insert and delete character 
operations in the terminal. 


The wrapmargin option can be fooled since it looks at output columns when blanks are typed. 
If a long word passes through the margin and onto the next line without a break, then the line 
won't be broken. 


Insert/delete within a line can be slow if tabs are present on intelligent terminals, since the ter- 
minals need help in doing this correctly. 


Saving text on deletes in the named buffers is somewhat inefficient. 


The source command does not work when executed as :source; there is no way to use the 
:append, :change, and :insert commands, since it is not possible to give more than one line of 
input to a : escape. To use these on a :global you must Q to ex command mode, execute 
them, and then reenter the screen editor with wor open. 
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vmstat — report virtual memory statistics 


SYNOPSIS 
vmstat [ ~fs] [ interval [ count ] } 


DESCRIPTION 
Vmstat delves into the system and normaily reports certain statistics kept about process, virtual 
memory, disk, trap and cpu activity. If given a ~f argument, it instead reports on the number 
of forks and vforks since system startup and the number of pages of virtual memory involved in 
each kind of fork. If given a —s argument, it instead prints the contents of the sum structure, 
giving the total number of several kinds of paging related events which have occurred since 
boot. 


If none of these options are given, vmsrar will report in a (usually) iterative fashion on the vir- 
tual memory activity in the system. In this case, the optional interva/ argument causes vmsiarto 
report once each interval seconds, ‘‘vrnsiat 4”’ will print what the system is doing every five 
seconds; this is a good choice of printing interval since this is how often some of the statistics 
are sampled in the system; others vary every second, running the output for a while will make 
it apparent which are recomputed every second. If a counris given, the Statistics are repeated 
count times. The format fields are: 


Procs: information about numbers of processes in various states. 


r im run queue ¢ 
b blocked for resources (i/o, paging, etc.) 
Ww runnable or short sleeper (< 20 secs) but swapped 


Memory: information about the usage of virtual and real memory. Virtual pages are considered 
active if they belong to processes which are running or have run in the last 20 seconds. A 
‘*page’’ here is 1024 bytes. 


avm active virtual pages 
fre size of the free list 


Page: information about page faults and paging activity. These are averaged each five seconds, 
and given in umits per second. 


re page reciaims (simulating reference bits) 

Di pages paged in 

po pages paged out 

fr pages freed per second 

de anticipated short term memory shortfall 

sr pages scanned by clock algorithm, per-second 


up/hp/rk: Disk operations per second (this field is system dependent). Typically paging will be 
split across several of the available drives. The number under each of these is the unit number. 


Faults: trap/interrupt rate averages per second over last 5 seconds. 


in (non clock) device interrupts per second 
sy system calls per second 
cs cpu context switch rate (switches/sec) 


Cpu: breakdown of percentage usage of CPU time 


us user time for normal and low priority processes 
Sy system time 
id cpu idle 


1-278 
4th Berkeley Distribution 4/26/81 


VMSTAT (1) UNIX Programmer’s Manual VMSTAT (1) 


FILES 
/dev/kmem, /vmunix 
SEE ALSO 
The sections starting with “‘Interpreting system activity’ in Serting up 4.lbsdby W. Joy. 
AUTHORS 
William Joy and Ozalp Babaoglu 
BUGS 


There should be a screen oriented program which combines vmstat and ps(1) in real time as 
well as reporting on other system activity. 
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NAME 
vpr, vprm, vpq, vprint — raster printer/plotter spooler 


SYNOPSIS 
vpr{ ~W) f—-1] f—v] [ —t [ ~1234 font] ] [ —w] [ ~wwidth] [ —m] [ name... ] 
vprm [| id... ] [ filename... ] [ owner... J 


vpq 
vprint | ~W ] file ... 


DESCRIPTION 
Vipr causes the named files to be queued for printing or typeset simulation on one of the avail- 
able raster printer/plotters. If no files are named, the standard input is read. By default the 
input is assumed to be line printer-like text. For very wide plotters, the input is run through 
the filter /usr/lib/sidebyside giving it an argument of ~wi106 which arranges it four pages adjacent 
with 90 column lines (the rest is for the left margin). Since there are 8 lines per inch in the 
default printer font, vpr thus produces 86 lines per page (the top and bottom lines are left 
blank). 


The following options are available: 


9 


— | Print the input in a more literal manner. Page breaks are not inserted, and 
most control characters (except format effect ctors: \n, \f, etc.) are printed (many 
control characters print special graphics not i n the ASCII character set.) Tab 
and underline processing is sull dece. If this option is not given, control char- 
acters which are not format effectors are ignored, and page breaks are inserted 
after an appropriate number of lines have been ie ee on a page. 


— W Queues files for printing om a wide output device, if available. Normally, files 
are queued for printing on a narrow output device. 

— 1234 Specifies a font to be mounted on font position « The daemon will construct a 
_railmay file referencing /usr/lib/vfontiname. Size. 

—m _ Report by siail(1) when printing is complete. 

— Ww (Applicable only to wide output devices.) Do not run the input through sideby- 


side. Such processing has been done already, or full (440 character) printer 
width is desired. 


—wiidth Use width width rather than 90 for sidebyside. 

—y Use the filter /usr/lib/vrast to convert the vectors to raster. The named files 
must be a parameter and vector file (in that order) created by versaplor(3x) 
routines. 

ser 

—t Use the filter /wsr/lib/vcat to typeset the input on the printer/plotter. The input 


must have been generated by trofll) run with the ~t option. This is not 
normally run directly to wide output devices, since it is wasteful to run only 
one page across. The program viroffil) is normally used and arranges, using 
vsort(1) for printing to occur four pages across, conserving paper. 


Vprim removes entries from the raster device queues. The id, filename or owner should be that 
reported by vpg. All apropriate files will be removed. Both queues are always searched. The id 
of each file removed from the queue will be printed. 


Vpq prints the queues. Each entry in the queue is printed showing the owner of the queue 
eniry, an identification number, the size of the entry in characters, and the file which ts to be 
printed. The dis useful for removing a specific entry from the printer queue using vprm 
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Vprint 1S a shell script which pr’s a copy of each named file on one of the electrostatic 
printer/plotters. The files are normally printed on a narrow device; —W option causes them to 
be printed on a wide device. 


FILES 
/usr/spool/v?d/s device spool areas 
/usr/lib/v?d | daemons 
/usr/lib/vpd Versatec daemon 
/usr/lib/vpf filter for printer simulation 
/usr/lib/=vcat . filter for typeset simulation 
/usr/lib/vrast filter for versaplot 
/usr/lib/sidebyside filter for wide output 
SEE ALSO 
troff(1), vfont(5), vp(4), pti(1), vtroff(1), versaplot (3x) 
BUGS 


You can’t run bit maps tn a queued fashion to the plotters. This is because the volume of the 
data (more than 1 Megabyte per vertical foot) is unwieldy. Instead you must follow the 
instructions in vp(4) and run your program when the plotter is idle, or run it in the background 


| and have it wait for the device to become idle. 


Queued jobs print in directory (seemingly random) order. The plotters are fast enough that 
this is not a real problern. 


The 1's (one’s) and I’s (lower-case el’s) in a Benson-Varian’s standard character set look very 
similar, caution is advised. 


Vprm should have options allowing just one of the queues to be searched. 


A versatec’s hardware character set is rather ugly. Vprint should use one of the constant width 
fonts to produce prettier listings. 
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NAME 
vtroff — troff to a raster plotter 


SYNOPSIS | 
vtroff { —w] { —F majorfont | | ~ 123 minorfont } [ —Length] [ —x ] troff arguments 


DESCRIPTION 

Virofruns troff{l) sending its output through various programs to produce typeset output on a 
raster plotter such as a Benson-Varian or or a Versatec. The —W option specifies that a wide 
output device be used; the default is to use a narrow device. The —]! (lower case |) option 
causes the output to be split onto successive pages every /ength inches rather than the default 
ie eae 

The default font is a Hershey font. If some other font is desired you can give a —F argument 
and then the font name. This will place normal, italic and bold versions of the font on posi- 
tions 1, 2, and 3. To place a font only on a single position, you can give an argument of the 
form -»” and the minor font name. A .r will be added to the minor font name if needed. 
Thus ‘‘vtroff —ms paper’’ will set a paper in the Hershey font, while ‘‘viroff —~F nonie —ms 
paper’’ will set the paper in the (sans serif) nonie font. The —x option asks for exact simula- 
tion of photo-typesetter output. (J.e. using the width tables for the C.A.T. photo-typesetter) 


FILES 
fusr/lib/tmac/tmac.veat default font mounts and bug fixes 
/usr/lib/fontinfo/* fixes for other fonts | 
/usr/lib/vfont directory containing fonts 

SEE ALSO 


trof(1), nettroffQ1), vfont(S), vpr(1) 


BUGS 
Since some macro packages work correctly only if the fonts named R, !, B, and S are mounted, 
and since the Versatec fonts have different widths for individual characters than the fonts found 
on the typesetter, the following dodge was necessary: If you don’t use the ‘‘.fp’’ troff directive 
then you get the widths of the standard typesetter fonts suitable for shipping the output of troff 
over the network to the computer center A machine for phototypesetting. If, however, you 
remount the R, I, B and S fonts, then you get the width tables for the Versatec. 
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NAME 

w — who is on and what they are doing 
SYNOPSIS 

wilh] [—s] [user ] 
DESCRIPTION 


W prints a summary of the current activity on the system, including what each user is doing. 
The heading line shows the current time of day, how long the system has been up, the number 
of users logged into the system, and the load averages. The load average numbers give the 
number of jobs in the run queue averaged over 1, 5 and 15 minutes. 


The fields output are: the users login name, the name of the tty the user is on, the time of day 
the user logged on, the number of minutes since the user last typed anything, the CPU time 
used by all processes and their children on that terminal, the CPU time used by the currently 
active processes, the name and arguments of the current process. 


The -h flag suppresses the heading. The -s flag asks for a short form of output. In the short 
form, the tty is abbreviated, the login time and cpu times are left off, as are the arguments to 
commands. -! gives the long output, which ts the default. 


If a user name is included, the output will be restricted to that user. 


FILES 
/etc/utmp 
/dev/kmem 
/dev/drum 


SEE ALSO 
who(1), finger(1), ps(1) 


AUTHOR 
Mark Horton 


BUGS 
The notion of the ‘‘current process’’ is muddy. The current algorithm is ‘‘the highest num- 
bered process on the terminal that is not ignoring interrupts, or, if there is none, the highest 
numbered process on the terminal’’. This fails, for example, in critical sections of programs 
like the shell and editor, or when faulty programs running in the background fork and fail to 
ignore interrupts. (In cases where no process can be found, w prints ‘*—’’.) 


The CPU time is only an estimate, in particular, if someone leaves a background process run- 
ning after logging out, the person currently on that terminal is ‘‘charged’’ with the time. 


Background processes are not shown, even though they account for much of the load on the 
system. 


Sometimes processes, typically those in the background, are printed with null or garbaged argu- 
ments. In these cases, the name of the command is printed in parentheses. 


W does not know about the new conventions for detection of background jobs. It will some- 
times find a background job instead of the right one. 
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NAME 
wait — await completion of process 


SYNOPSIS 
wait 
DESCRIPTION 
Wait until all processes started with & have completed, and report on abnormal terminations. 


Because the wait(2) systern call must be executed in the parent process, the Shell itself exe- 
cutes wait, without creating a new process. 


SEE ALSO 
sh(1) 


Not all the processes of a 3- or more-stage pipeline are children of the Shelli, and thus can 
waited for. (This bug does not apply to csh(1).) 
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NAME 
wall — write to all users 


SYNOPSIS 
wall 


DESCRIPTION | 
Wall reads its standard input until an end-of-file. It then sends this message, preceded by 
‘Broadcast Message ...”, to all logged in users. 


The sender should be super-user to override any protections the users may have invoked. 


FILES 
/dev/tty? 
/etc/utmp 


SEE ALSO 
mesg(1), write(1) 


DIAGNOSTICS | 
‘Cannot send to ...” when the open on a user’s tty file fails. 
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we — word count 


SYNOPSIS 


DESCRIP 


BUGS 


we | ~Iwept |] [ —bdaud] [ —spagesize] [ ~u] [ —v ] [ name ... ] 


TION 

We counts lines, words and characters, and optionally pages and the print time, in the named 
files, or in the standard input if no name appears. A word is a maximal string of characters del- 
imited by spaces, tabs or newlines. 


If an argument beginning with one of ‘‘Ilwcpt’’ is present, the specified counts (lines, words, 
characters, pages, or time) are selected by the letters 1, w, ec, Pp. oF t. The default is -Iwe 
unless ~v is specified. 


The —b option asks that the time be figured at the specified baud rate instead of the default 
300 baud. 


The —s option specifies that pages are pagesize lines long instead of the default 66. 


The —w options asks that the time printed be based on uucp transmission time, about 90% as 
fast as normal. 


The —v option asks for a verbose output format, with headers and including pages and time by 
default 


The times given do not take into account variable factors such as system load: delays due to tab 
expansion or tty driver delays, which can be a factor with cu; or uucp delays such as mail 
headers, auxillary protocol files, or the time taken to initially connect to another site. 
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NAME 

what — show what versions of object modules were used to construct a file 
SYNOPSIS 

what name ... 
DESCRIPTION 


What reads each file and searches for sequences of the form ‘‘@(#)’’ as inserted by the source 
code control system. It then prints the remainder of the string after this marker, up to a null 
character, newline, double quote, or ‘*>’’ character. 


BUGS 


As SCCS is not licensed with UNIX/32V, this is a rewrite of the what command which is part 
of SCCS, and may not behave exactly the same as that command does. 
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NAME 
whatis — describe what a command is 

SYNOPSIS | 
whatis command ... 

DESCRIPTION 
Whatis looks up a given command and gives the header line from the manual section. You can 
then run the man(1) command to get more information. If the line starts ‘name(section) ...’ 
you can do ‘man section name’ to get the documentation for it. Try ‘whatis ed’ and then you 
should do ‘man 1 ed’ to get the manual. 
Whatis is actually just the —f option to the man(1) command. 

FILES 
fusr/lib/whatis Data base 

SEE ALSO 
apropos(1), man(1), catman(8) 

AUTHOR 


William Joy 
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NAME 
who — who is on the system 


SYNOPSIS 
who [ who-file ] [am I ] 


DESCRIPTION 


Who, without an argument, lists the login name, terminal name, and login time for each 
current UNIX user. 


Without an argument, who examines the /etc/utmp file to obtain its information. If a file is 
given, that file is examined. Typically the given file will be /usr/adm/wtmp, which contains a 
record of all the logins since it was created. Then who lists logins, logouts, and crashes since 
the creation of the wtmp file. Each login is listed with user name, terminal name (with ‘/dev/’ 
suppressed), and date and time. When an argument is given, logouts produce a similar line 
without a user name. Reboots produce a line with ‘x’ in the place of the device name, and a 
fossil time indicative of when the system went down. 


With two arguments, as in ‘who am [’ (and also ‘who are you’), who tells who you are logged 
in as. 
FILES 
fetc/utmp 


SEE ALSO 
getuid(2), utmp(5) 
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NAME 
whoami — print effective current user id 


SYNOPSIS 
whoami 


DESCRIPTION 


_ Whoami prints who you are. It works even if you are su’d, while ‘who am i’ does not since it 
uses /etc/utmp. 


FILES 
/etc/passwd § Name data base 


SEE ALSO 
— who (1) 
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NAME 


write — write to another user 


SYNOPSIS 


write user [ ttyname |] 


DESCRIPTION 


Write copies lines from your terminal to that of another user. When first called, it sends the 
message 


Message from yourname yourttyname... 


The recipient of the message should write back at this point. Communication continues until 


an end of file is read from the terminal or an interrupt is sent. At that point write writes ‘EOT’ 
on the other terminal and exits. 


If you want to write to a user who is logged in more than once, the ‘tyname argument may be 
used to indicate the appropriate terminal name. 


Permission to write may be denied or granted by use of the mesg command. At the outset writ- 
ing is allowed. Certain commands, in particular nroff and pr(1) disallow messages in order to 
prevent messy output. 


If the character ‘!’ is found at the beginning of a line, write calls the shell to execute the rest of 
the line as a command. 


The following protocol is suggested for using write: when you first write to another user, wait 
for him to write back before starting to send. Each party should end each message with a dis- 


tinctive signal—(o) for ‘over’ is conventional—that the other may reply. (oo) for ‘over and 
out’ is suggested when conversation is about to be terminated. 


FILES 
/etc/utmp to find user 
/pin/sh _ to execute ‘!” 
SEE ALSO 


mesg(1), who(1), mail(1) 
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NAME 
xsend, xget, enroll — secret mail 


SYNOPSIS 
xsend person 
xget 
enroll 

DESCRIPTION 
These commands implement a secure communication channel; it is like mai/(1), but no one can 
read the messages except the intended recipient. The method embodies a public-key cryptosys- 
tem using knapsacks. 


To receive messages, use enroll, it asks you for a password that you must subsequently quote in 
order to receive secret mail. 


To receive secret mail, use xget. It asks for your password, then gives you the messages. 


To send secret mail, use xsend in the same manner as the ordinary mail command. (However, 
it will accept only one target). A message announcing the receipt of secret mail is also sent by 
ordinary mail. 

FILES 
/usr/spool/secretmail/*.key: keys /usr/spool/secretmail/*. [0-9]: messages 


SEE ALSO 
mail (1) 


BUGS 
It should be integrated with ordinary mail. The announcement of secret mail makes traffic 
analysis possible. 
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NAME 


xstr — extract strings from C programs to implement shared strings 


SYNOPSIS 


xstr [—c] [— ]} [ file] 


DESCRIPTION 


Xstr maintains a file strings into which strings in component parts of a large program are hashed. 
These strings are replaced with references to this common area. This serves to implement 
shared constant strings, most useful if they are also read-only. 


The command 


xStr —c name 


will extract the strings from the C source in name, replacing string references by expressions of 
the form (&xstr{number]) for some number. An appropriate declaration of xstr is prepended to 
the file. The resulting C text is placed in the file x.c, to then be compiled. The strings from 
this file are placed in the strings data base if they are not there already. Repeated strings and 
strings which are suffices of existing strings do not cause changes to the data base. 


After all components of a large program have been compiled a file xs.c declaring the common 
xstr Space can be created by a command of the form 


xstr 
This xs.c file should then be compiled and loaded with the rest of the program. If possible, the 
array can be made read-only (shared) saving space and swap overhead. 
Xstr can also be used on a single file. A command 

xstr name 


creates files x.c and xs.c as before, without using or affecting any strings file in the same direc- 
tory. 


It may be useful to run xsir after the C preprocessor if any macro definitions yield strings or if 
there is conditional code which contains strings which may not, in fact, be needed. Xsir reads 
from its standard input when the argument ‘—’ is given. An appropriate command sequence 
for running xstr after the C preprocessor is: 


ee ~E name.c|xstr ec — 
ce Cc X.c 
mv X.o name.o 


‘ser does not touch the fle sirings ut ess aes eons are added, ‘aus meke can avoid remaking 
.s.o unless truly necessary. 
FILES 
strings Data base of strings 
Kc Massaged C source 
XS.C C source for definition of array ‘xstr’ 
/tmp/xs* Temp file when ‘xstr name’ doesn’t touch strings 
SEE ALSO 
mkstr(1) 
AUTMUK 
William Joy 
BUGS 


If a string is a suffix of another string in the data base, but the shorter string is seen first by xstr 
both strings will be placed in the data base, when just placing the longer one there will do. 
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NAME 
yacc ~ yet another compiler-compiler 
SYNOPSIS 
yace { ~vd] grammar 
DESCRIPTION 
Yacc converts a context-free grammar into a set of tables for a simple automaton which exe- 


cutes an LR(1) parsing algorithm. The grammar may be ambiguous; specified precedence rules 
are used to break ambiguities. 


The output file, y.sab.c, must be compiled by the C compiler to produce a program yyparse. 
This program must be loaded with the lexical analyzer program, yy/ex, as well as mainand yyer- 
ror, an error handling routine. These routines must be supplied by the user, Lex(1) is usefui 
for creating lexical analyzers usable by pace. 


If the —v flag is given, the file y.oupur is prepared, which contains a description of the parsing 
tables and a report on conflicts generated by ambiguities in the grammar. 


If the —d flag is used, the file y.zab.h is generated with the define statements that associate the 
yaceassigned ‘token codes’ with the user-declared ‘token names’. This allows source files other 
than y.tab.cto access the token codes. 


FILES 
y.output 
y.tabd.c 
y.tab.h defines for token names 
yace.tmp, yacc.acts temporary files 
/usr/lib/yaccpar parser prototype for C programs 


SEE ALSO 
lex(1) | 
LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 
YACC — Yer Another Compiler Compiler by S. C. Johnson. 


DIAGNOSTICS 
The number of reduce-reduce and shift-reduce conflicts is reported on the standard output: a 
more detailed report is found in the y.oumpur file. Similarly, if some rules are not reachable 
from the start symbol, this is also reported. 

BUGS 
Because file names are fixed, at most one yacc process can be active in a given directory at a 
time. 
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NAME 
| yes — be repetitively affirmative 
SYNOPSIS 
yes [ expletive ] 
DESCRIPTION 


Yes repeatedly outputs “‘y’’, or if expletive is given, that is output repeatedly. Termination is 
by rubout. 


BUGS 
Boring. 
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NAME 


intro, errno — introduction to system calls and error numbers 


SYNOPSIS 


#include <errno.h> 


DESCRIPTION 


Section 2 of this manual describes all the entries into the system. Distinctions as to the status 
of the entries are made in the headings: 


(2) System call entries which are standard in Version 7 UNIX systems. 


(2J) System call entries added in support of the job control mechanisms of csh(1). These 
system calls are not available in standard Version 7 UNIX systems, and should be used 
only when necessary; to prevent inexplicit use they are contained in the /jods library 
which must be specifically requested with the —ljobs loader option. The use of condi- 
tional compilation is recommented when possible so that programs which use these 
features will gracefully degrade on systems which lack job control. 


(2V) System calls added for the Virtual Memory version of UNIX distributed by Berkeley. 
Some of these calls are likely to be replaced by new facilities in future versions; in cases 
where this is imminent, this is indicated in the individual manual pages. 


An error condition is indicated by an otherwise impossible returned value. Almost always this 
is ~1; the individual sections specify the details. An error number is also made available in the 
external variable errno. Errnois not cleared on successful calls, so it should be tested only after 
an error has occurred. 


There is a table of messages associated with each error, and a routine for printing the message; 
See perror(3). The possible error numbers are not recited with each writeup in section 2, since 
many errors are possible for most of the calls. Here is a list of the error numbers, their names 
as defined in <errno.h>, and the messages available using perror. 
0 Error 0 

Unused. 


1 EPERM Not owner 
Typically this error indicates an attempt to modify a file in some way forbidden except 
to its owner or super-user. It is also returned for attempts by ordinary users to do 
things allowed only to the super-user. 

2 ENOENT No such file or directory 
This error occurs when a file name is specified and the file should exist but doesn't, or 
when one of the directories in a path name does not exist. 

3 ESRCH No such process | 


The process whose number was given to signal and pirace does not exist, or is already 
dead. 


4 EINTR Interrupted system call 
An asynchronous signal (such as interrupt or quit), which the user has elected to catch, 


occurred during a system call. If execution is resumed after processing the signal, it 
will appear as if the interrupted system call returned this error condition. 


5 EIO I/O error 
Some physical I/O error occurred during a reador write. This error may in some cases 
occur on a call following the one to which it actually applies. 

6 ENXIO No such device or address 


I/O on a special file refers to a subdevice which does not exist, or beyond the limits of 
the device. It may also occur when, for example, a tape drive is not dialed in or no 
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disk pack is loaded on a drive. 


7 E2BIG Arg list too long 
An argument list longer than 10240 bytes is presented to exec. 

8 ENOEXEC Exec format error 
A request is made to execute a file which, although it has the appropriate permissions, 
does not start with a valid magic number, see a.our(5). 

9 EBADF Bad file number | 
Either a file descriptor refers to no open file, or a read (resp. write) request is made to 
a file which is open only for writing (resp. reading). 


10 ECHILD No children 
Waitand the process has no living or unwaited-for children. 

11 EAGAIN No more processes 
In a fork, the system's process table is full or the user is not allowed to create any more 
processes. 


12 ENOMEM Not enough core 
During an exec or break, a program asks for more core than the system is able to sup- 
ply. This is not a temporary condition, the maximum core size is a system parameter. 
The error may also occur if the arrangement of text, data, and stack segments requires 
too many segmentation registers. 


13 EACCES Permission denied 
An attempt was made to access a file in a way forbidden by the protection system. 
14 EFAULT Bad address 
The system encountered a hardware fault in attempting to access the arguments of a 
A plain file was mentioned where a block device was required, ¢.g. in mount. 
16 EBUSY Mount device busy 
An attempt to mount a device that was already mounted or an attempt was made to 


dismount a device on which there is an active file directory. (open file, current direc- 
tory, mounted-on file, active text segment). 


17 EEXIST File exists | 
An existing file was mentioned in an inappropriate context, e.g. link. 

18 EXDEV Cross-device link 
A link to a file on another device was atternpted. 

19 ENODEV No such device | 
An attempt was made to apply an inappropriate system call to a device; e.g. read a 
write-only device. 

20 ENOTDIR Not a directory 
A non-directory was specified where a directory is required, for example in a path name 
or as an argument to cAédir. 


21 EISDIR Is a directory 
An attempt to write on a directory. 


22 EINVAL Invalid argument 
Some invalid argument: dismounting a non-mounted device, mentioning an unknown 
signal in signal, reading or writing a file for which seek has generated a negative pointer. 
Also set by math functions, see intro(3). 
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23 ENFILE File table overflow 

The system’s table of open files is full, and temporarily no more opens can be accepted. 
24 EMFILE Too many open files 

Customary configuration limit is 20 per process. 
25 ENOTTY Not a typewriter 


The file mentioned in szty or tty is not a terminal or one of the other devices to which 
these calls apply. 


26 ETXTBSY Text file busy 


An attempt to execute a pure-procedure program which is currently open for writing 


(or reading!). Also an attempt to open for writing a pure-procedure program that is 
being executed. 


27 EFBIG File too large 
The size of a file exceeded the maximum (about 10° bytes). 
28 ENOSPC No space left on device 
During a write to an ordinary file, there is no free space left on the device. 
29 ESPIPE Illegal seek 
An lseek was issued to a pipe. This error should also be issued for other non-seekable 
devices. 
30 EROFS Read-only file system ' 
An attempt to modify a file or directory was made on a device mounted read-only. 
31 EMLINK Too many links 
An attempt to make more than 32767 links to a file. 
32 EPIPE Broken pipe 
A write on a pipe for which there is no process to read the data. This condition nor- | 
mally generates a signal; the error is returned if the signal is ignored. 
33 EDOM Math argument 
The argument of a function in the math package (3M) is out of the domain of the 
function. 
34 ERANGE Result too large 
The value of a function in the math package (3M) is unrepresentable within machine 
precision. 
SEE ALSO 
intro(3) 
ASSEMBLER (PDP-11) 
as /usr/include/sys.s file ... 
The PDP11 assembly language interface is given for each system call. The assembler symbols 
are defined in ‘/usr/include/sys.s’. 
Return values appear in registers r0 and rl; it is unwise to count on these registers being 
preserved when no value is expected. An erroneous call is always indicated by turning on the 
c-bit of the condition codes. The error number is returned in r0. The presence of an error is 
most easily tested by the instructions Ses and bec (‘branch on error set (or clear)’). These are 
synonyms for the bcsand dcc instructions. 


On the Interdata 8/32, the system call arguments correspond well to the arguments of the C 
routines. The sequence is: 


la % 2, errno 
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%0,d&callno 
svc O,args 
Thus register 2 points to a word into which the error number will be stored as needed; it is 
cleared if no error occurs. Register 0 contains the system call number, the nomenciature is 
identical to that on the PDP11. The argument of the svc is the address of the arguments, laid 
out in storage as in the C calling sequence. The return value is in register 2 (possibly 3 also, as 
in pipe) and is ~1 in case of error. The overflow bit in the program status word is also set 
when errors occur. 


On the VAX-11 a system call follows exactly the same conventions as a C procedure. Namely, 
register ap points to a long word containing the number of arguments, and the arguments fol- 
low in successive long words. Values are returned in registers r0 and ri. An error is indicated 
by setting the C (carry) bit in the processor status word; the error number is placed in r0. 


BUGS 
The message ‘‘Mount device busy” is reported when a terminal is inaccessible because the 
*“exclusive use’” bit is set; this is confusing. 
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NAME 
access — determine accessibility of file 


SYNOPSIS 
access (name, mode) 
char *name; 


DESCRIPTION 
Access checks the given file name for accessibility according to mode, which is 4 (read), 2 
(write) or 1 (execute) or a combination thereof. Specifying mode 0 tests whether the direc- 
tories leading to the file can be searched and the file exists. 


AN appropriate error indication is returned if name cannot be found or if any of the desired 
access modes would not be granted. On disallowed accesses —1 is returned and the error code 
is in errno. Q is returned from successful tests. 


The user and group [Ds with respect to which permission is checked are the real UID and GID 
of the process, so this call is useful to set-UID programs. 


Notice that it is only access bits that are checked. A directory may be announced as writable by 
access, but an attempt to open it for writing will fail (although files may be created there), a file 
may look executable, but exec will fail unless it is in proper format. 


SEE ALSO 
stat (2) 


ASSEMBLER (PDP-11) 
(access = 33.) 
SyS access; name; mode 
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NAME 
acct — turn accounting on or off 


SYNOPSIS 
acct (file) 
char efile: 


DESCRIPTION 
The system is prepared to write a record in an accounting /ile for each process as it terminates. 
This call, with a null-terminated string naming an existing file as argument, turns on account- 
ing; records for each terminating process are appended to file. An argument of 0 causes 
accounting to be turned off. 


The accounting file format is given in accr(5). 


SEE ALSO 
acct(5), sa(8) 


DIAGNOSTICS 
On error —1 is returned. The file must exist and the call may be exercised only by the super- 
user. It is erroneous to try to turn on accounting when it is already on. 

BUGS 
No accounting is produced for programs running when a crash occurs. In particular nonter- 
minating programs are never accounted for. 


ASSEMBLER (PDP-11) 
(acct = 51.) 
Sys acct; file 


7th Edition | os 


ALARM (2). UNIX Programmer’s Manual ALARM (2) 


NAME 
alarm — schedule signal after specified time 


SYNOPSIS 
alarm (seconds) 
unsigned seconds; 


DESCRIPTION | 
Alarm causes signal SIGALRM, see signa/(2), to be sent to the invoking process in a number 
of seconds given by the argument. Unless caught or ignored, the signal terminates. the process. 


Alarm requests are not stacked; successive calls reset the alarm clock. If the argument is 0, any 
alarm request is canceled. Because the clock has a l-second resolution, the signal may occur up 
to one second early; because of scheduling delays, resumption of execution of when the signal 
is caught may be delayed an arbitrary amount. The longest specifiable delay time ts 2147483647 
seconds. , | 


The return value is the amount of time previously remaining in the alarm clock. 


SEE ALSO 
pause(2), signal(2), sigsys(2), sigset(3), sleep(3) 


ASSEMBLER (PDP-11) 
(alarm = 27.) 
(seconds in r0) 
Sys alarm 
(previous amount in rQ) 
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NAME 


brk, sbrk, break — change core allocation 


SYNOPSIS 


char ebrk (addr) 
char esbrk (incr) 


DESCRIPTION 


Brk sets the system's idea of the lowest location not used by the program (called the break) to 
addr (rounded up to the next multiple of 64 bytes on the PDP11, 256 bytes on the Interdata 
8/32, and 1024 bytes on a VAX-11). Locations not less than addr and below the stack pointer 
are not in the address space and will thus cause a memory violation if accessed. 


In the alternate function sdrk, incr more bytes are added to the program's data space and a 
pointer to the start of the new area is returned. 


When a program begins execution via exec the break is set at the highest location defined by 
the program and data storage areas. Ordinarily, therefore, only programs with growing data 
areas need to use break. 


The viimit(2) system call may be used to determine the maximum permissible size of the dara 
region; it will not be possible to set the break beyond ‘“‘etext + viimit(LIM_DATA, —1).”’ 
(See end(3) for the definition of erexr.) 


SEE ALSO 


exec(2), vlimit(2), malloc(3), end(3) 


DIAGNOSTICS 


BUGS 


Zero is returned if the brk could be set; —1 if the program requests more memory than the sys- 
tem limit or if too many segmentation registers would be required to implement the break. 
Sbrk returns — 1 if the break could not be set. 


Setting the break in the range 0177701 to 0177777 (on the PDP11) is the same as setting it to 
zero. 


ASSEMBLER (PDP-11) 


(break = 17.) 
sys break; addr 


Break performs the function of brk. The name of the routine differs from that in C for histori- 
cal reasons. 
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NAME | 
chdir — change current working directory 
SYNOPSIS 
chdir (dirname) 
char «dirname; 
DESCRIPTION 
Dirname is the address of the pathname of a directory, terminated by a null byte. Chdir causes 
this directory to become the current working directory, the starting point for path names not 
beginning with ‘/’. 
SEE ALSO 
cd(1) 


DIAGNOSTICS 
Zero is returned if the directory is changed; —1 is returned if the given name is not that of a 
directory or ts not searchable. 
ASSEMBLER 
(chdir = 12.) 
sys chdir; dirname 
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NAME fe 
chmod — change mode of file 


SYNOPSIS 
chmod(name, mode) 
char *name; 


DESCRIPTION 
The file whose name is given as the null-terminated string pointed to by name has its mode 
changed to mode. Modes are constructed by oring together some combination of the following: 


— 04000 set user ID on execution 
02000 set group ID on execution 
01000 save text image after execution 
00400 read by owner 
00200 write by owner 
00100 execute (search on directory) by owner 
00070 read, write, execute (search) by group 
00007 read, write, execute (search) by others 


If an executable file is set up for sharing (this is the default) then mode 1000 prevents the sys- 
tem from abandoning the swap-space image of the program-text portion of the file when its last 
user terminates. Ability to set this bit is restricted to the super-user since swap space is con- 
sumed by the images. See sticky(8). 


Only the owner of a file (or the super-user) may change the mode. Only the super-user can set 
the 1000 mode. 


On some systems, writing or changing the owner of a file turns off the set-user-id bit. This 
makes the system somewhat more secure by protecting set-user-id files from remaining set- aoe 
user-id if they are modified, at the expense of a degree of compatibility. 


SEE ALSO 
chmod(1) 


DIAGNOSTIC 
Zero is returned if the mode is changed; —1 is returned if name cannot be found or if the 
current user is neither the owner of the file nor the super-user. 

ASSEMBLER (PDP-11) 


(chmod = 15.) 
sys chmod; name; mode 
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NAME 
chown — change owner and group of a file 
SYNOPSIS 
chown(name, owner, group) 
char *name; 
DESCRIPTION 


The file whose name is given by the null-terminated string pointed to by name has its owner and 
group changed as specified. Only the super-user may execute this call, because if users were 
able to give files away, they could defeat the (nonexistent) file-space accounting procedures. 


On some systems, chown clears the set-user-id bit on the file to prevent accidental creation of 
set-user-id programs owned by the super-user. | 
SEE ALSO | 
chown(]), passwd(5) 
DIAGNOSTICS 
Zero is returned if the owner is changed; —1 is returned on illegal owner changes. 
ASSEMBLER (PDP-11) 


(chown = 16.) 
sys chown; name; owner; group 
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NAME 
close — close a file 


SYNOPSIS 
close (fildes) 


DESCRIPTION | 
Given a file descriptor such as returned from an open, creat, dup or pipe{2) call, close closes the 
associated file. A close of all files is automatic on exit, but since there is a limit on the number 
of open files per process, close is necessary for programs which deal with many files. 


Files are closed upon termination of a process, and certain high-numbered file descriptors are 
closed by exec(2), and it is possible to arrange for others to be closed (see FIOCLEX in 
ioctl(2)). | 


SEE ALSO | 
creat(2), open(2), pipe(2), exec(2), ioctl(2) 


DIAGNOSTICS 
Zero is returned if a file is closed; —1 is returned for an unknown file descriptor. 


ASSEMBLER (PDP-1)) 
(close = 6.) 
(file descriptor in r0) 
sys close 

BLGS | 

A file cannot be closed while there are pages which have been vread but not referenced. 
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NAME 


creat — create a new file 


SYNOPSIS 


creat(name, mode) 
char *name; 


DESCRIPTION 


Creat creates a new file or prepares to rewrite an existing file called name, given as the address 
of a null-terminated string. If the file did not exist, it is given mode mode, as modified by the 
process's mode mask (see uwmask(2)). Also see chmod(2) for the construction of the sode 
argument. 


If the file did exist, its mode and owner remain unchanged but it is truncated to 0 length. 
The file is also opened for writing, and its file descriptor is returned. 


The mode given is arbitrary; it need not allow writing. This feature is used by programs which 
deal with temporary files of fixed names. The creation is done with a mode that forbids writing. 
Then if a second instance of the program attempts a creat, an error is returned and the program 
knows that the name is unusable for the moment. 


SEE ALSO 


write(2), close(2), chmod(2), umask (2) 


DIAGNOSTICS 


The value —1 is returned if: a needed directory is not searchable: the file does not exist and the 
directory in which it is to be created is not writable: the file does exist and is unwritable; the file 


is a directory; there are already too many files open. 


ASSEMBLER (PDP-11) 


BUGS 


(creat = 8.) 
SYS creat; name; mode 
(file descriptor in rQ) 


A file cannot be truncated while any process has pages set up by a vread on that file which have 
not been referenced. 
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NAME 
dup, dup2 — duplicate an open file descriptor 


SYNOPSIS 
dup (fildes) 
int fildes; 


dup2(fildes, fildes2) 
int fildes, fildes2; 


DESCRIPTION 
Given a file descriptor returned from an open, pipe, or creat call, dup allocates another file 
descriptor synonymous with the original. The new file descriptor is returned. 


in the second form of the call, fildes is a file descriptor referring to an open file, and fi/des2 is a 
non-negative integer less than the maximum value allowed for file descriptors (approximately 
19). Dup2 causes fildes2 to refer to the same file as fildes. If Aldes2 already referred to an open 
file, it is closed first. . 


SEE ALSO 
creat(2), open(2), close(2), pipe(2) 


DIAGNOSTICS 
The value —] is returned if: the given file descriptor is invalid, there are already too many 
open files. 


ASSEMBLER (PDP-11) 
(dup = 41.) 
(file descriptor in r0) 
(new file descriptor in rl) 
sys dup 
(file descriptor in r0) 


The dup2 entry is implemented by adding 0100 to fides. 


BUGS 
Dup2 fails if fides? was vread from and some of the pages have not been referenced. 


7th Edition 


EXEC (2) UNIX Programmer’s Manual EXEC (2) 


NAME 

exec], execv, execle, execve, execip, execvp, exec, exece, environ — execute a file 
SYNOPSIS 

execl(name, arg9, argl, ..., argn, 0) 

char *name, *earg0, arg], ..., *argn; 

execy (name, argv) 

char *name, *argvl); 


execle(name, arg0, argl, ..., argn, 0, envp) 
char ¢name, *arg0, *argl, ..., eargn, eenvpll; 


execve(name, argv, envp) 
char ¢name, eargvil, eenvpll; 


extern char **environ; 


DESCRIPTION 


Exec in all its forms overlays the calling process with the named file, then transfers to the entry 


point of the core image of the file. There can be no return from a successful exec; the calling 
core image is lost. | 


Files remain open across exec unless explicit arrangement has been made; see iocr/(2). 
Ignored/held signals remain ignored/held across these calls, but signals that are caught (see sig- 
nal(2)) are reset to their default values. 


Each user has a rea/user ID and group ID and an effective user ID and group ID. The real ID 
identifies the person using the system; the effective ID determines his access privileges. Exec 
changes the effective user and group ID to the owner of the executed file if the file has the 
‘set-user-1D’ or ‘set-group-ID’ modes. The real user ID is not affected. 


The name argument is a pointer to the name of the file to be executed. The pointers arg[0}, 
arg{ 1] ... address null-terminated strings. Conventionally arg{0] is the name of the file. 


From C, two interfaces are available. exec/is useful when a known file with known arguments 
is being called; the arguments to exec/ are the character strings constituting the file and the 
arguments; the first argument is conventionally the same as the file name (or its last com- 


ponent). AO argument must end the argument list. 


The execv version is useful when the number of arguments is unknown in advance; the argu- 
ments to execv are the name of the file to be executed and a vector of strings containing the 
arguments. The last argument string must be followed by a 0 pointer. 


When a C program is executed, it is called as follows: 


main (argc, argv, envp) 
int argc; 
char **argv, **envp; 
where argc is the argument count and argv is an array of character pointers to the arguments 


themselves. As indicated, argc is conventionally at least one and the first member of the array 
points to a string containing the name of the file. 


Argvis directly usable in another execv because argvlargc] is 0. 


Enyp is a pointer to an array of strings that constitute the environment of the process. Each 
string consists of a name, an ‘‘=”’, and a null-terminated value. The array of pointers is ter- 
minated by a null pointer. The shell sA(1) passes an environment entry for each global shell 
variable defined when the program is called. See environ(S) for some conventionally used 
names. The C run-time start-off routine places a copy of envpin the global cell environ, which 
is used by execv and exec/to pass the environment to any subprograms executed by the current 
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FILES 


program. The exec routines use lower-ievel routines as follows to pass an environment expli- 
citly: 

execve (file, argv, environ); — 

execie (file, argO, argl, ... , argn, 0, environ): 


Execip and execvp are called with the same arguments as exec/ and execv, but duplicate the 
shell’s actions in searching for an executable file in a list of directories. The directory list is 
obtained from the environment. 


To aid execution of command files of various programs, if the first two characters of the exe- 
cutable file are "#" then exec attempts to read a pathname from the executable file and use that 
program as the command files command interpreter. For example, the following command file 
sequence would be used to begin a csA script: 

#! /bin/csh 

# This shell script computes the checksum on /dev/foobar 

is 


A single parameter may be passed the interpreter, specified after the name of the interpreter; its 
length and the length of the name of the interpreter combined must not exceed 32 characters. 
The space (or tab) following the '#!" is mandatory, and the pathname must be explicit (no 
paths are searched). 


/bin/sh shell, invoked if command file found by execipor execvp 


SEE ALSO 


fork (2), environ(5), csh(1) 


DIAGNOSTICS 


BUGS 


If the file cannot be found, if it is not executable, if it does not start with a valid magic number 
(see a.our(5)), if maximum memory is exceeded, or if the arguments require too much space, 
a return constitutes the diagnostic; the return value is ~1. Even for the super-user, at least 
one of the execute-permission bits must be set for a file to be executed. 


If execvp is called to execute a file that turns out to be a shell command file, and if it is impossi- 
ble to execute the shell, the values of argv/0/and argv{— 1] will be modified before return. 


ASSEMBLER (PDP-11) 
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(exec = 11.) 
SYS exec; name; argv 


(exece = 59.) 
sys exece; name; argy; envp 


Plain execis obsoleted by exece, but remains for historical reasons. 


When the called file starts execution on the PDP11, the stack pointer points to a word contain- 
ing the number of arguments. Just above this number is a list of pointers to the argument 
strings, followed by a null pointer, followed by the pointers to the environment strings and then 


another null pointer. The strings themselves follow, a 0 word is left at the very top of memory. 
sp =nargs 
arg0 


argn 
0 


envd 
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envm 
0 


arg0: <arg0\0> 


env0: <env0\0> 
0 


On the Interdata 8/32, the stack begins at a conventional place (currently 0xD0000) and grows 
upwards. After exec, the layout of data on the stack is as follows. 


int 0 
arg0: byte 


argp0: int arg0 


int 0 


envp0: int env0 
int 0 
%2—- space 40 
int nargs 
int argp0 
int envp0 


%3I— 
This arrangement happens to conform well to C calling conventions. 


On a VAX-11, the stack begins at Ox7ffff000 and grows towards lower numbered addresses. 
After exec, the layout of data on the stack is as follows. 
ap — 
fp-— 
sp — .long nargs 

Jong argO 

long argn 

long 0 

long env0 

long envn 

long 0 
argQ: .byte "arg0\0" 


envn: .byte “envn\0" 
long 0 
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NAME 
exit — terminate process 
SYNOPSIS 
exit (status) 
int status; 
_exit (status) 
int status; 
DESCRIPTION 
Exit is the normal means of terminating a process. Exit closes ali the process’s files and notifies 
the parent process if it is executing a wait. The low-order 8 bits of status are available to the 
parent process. 


This call can never return. 


The C function exit may cause cleanup actions before the final ‘sys exit’. The function _exir cir- 
cumvents ail cleanup, and should be used to terminate a child process after a fork(2) or 
vfork(2) to avoid flushing buffered output twice. 


SEE ALSO 
fork(2), vfork(2), wait(2) 


ASSEMBLER (PDP-11) 
(exit = 1.) 
(status in r0) 
SYS exil 
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NAME 


fork — spawn new process 


SYNOPSIS 


fork QO 


DESCRIPTION 


Fork and vfork(2) are the only ways new processes are created. With fork , the new process’s 
core image is a copy of that of the caller of fork. The only distinction is the fact that the value 
returned in the old (parent) process contains the process ID of the new (child) process, while 
the value returned in the child is 0. Process ID’s range from 1 to 30,000. This process ID is 
used by wait(2). . 


Files open before the fork are shared, and have a common read-write pointer. In particular, 
this is the way that standard input and output files are passed and also how pipes are Set up. 


Vfork is the most efficient way of creating a new process when the fork is to be followed shortly 
by an exec, but is not suitable when the fork is not to be followed by an exec. 


SEE ALSO 


wait(2), exec(2), vfork (2) 


DIAGNOSTICS 


Returns —1 and fails to create a process if: there is inadequate swap space, the user 1s not 
super-user and has too many processes, or the system’s process table is full. Only the super- 
user can take the last process-table slot. 


ASSEMBLER (PDP-11) 


(fork = 2.) 

SYS fork 

(new process return) 

(old process return, new process ID in r0) 


The return locations in the old and new process differ by one word. The C-bit ts set in the old 
process if a new process could not be created. 
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NAME 
getpid — get process identification 
SYNOPSIS 
getpid () 
DESCRIPTION 
Getpid returns the process [D of the current process. Most often it is used to generate 
uniquely-named temporary files. 


SEE ALSO 
mktemp(3) 
ASSEMBLER (PDP-1) 
(getpid = 20.) 
SYS getpid 
(pid in r0) 
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NAME 
getuid, getgid, geteuid, getegid — get user and group identity 
SYNOPSIS 
getuid () 
geteuid () 
getgid () 
getegid () 
DESCRIPTION 
Getuid returns the real user ID of the current process, gefeuid the effective user ID. The real 
user ID identifies the person who is logged in, in contradistinction to the effective user ID, 


which determines his access permission at the moment. It is thus useful to programs which 
operate using the ‘set user [D’ mode, to find out who invoked them. 


Gergid returns the real group ID, geregid the effective group ID. 


SEE ALSO 
setuid (2) 
ASSEMBLER (PDP-11) 
(getuid = 24.) 
Sys getuid 
(real user ID in r0, effective user ID in rl) 
(getgid = 47.) 
SYS getgid 
(real group ID in r0, effective group ID in rl) 
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NAME | 
ioctl, stty, gity — control device 


SYNOPSIS 
#include <sgtty.h> 
iocti(fildes, request, argp) 
Struct sgttyb *argp; 
stty (fildes, argp) 
Struct sgttyb *argp; 
gtty (fildes, argp) 
struct sgttyb *argp; 
DESCRIPTION 
loctl performs a variety of functions on character special files (devices). The writeups of vari- 
ous devices in section 4 discuss how ioctl! applies to them. 
For certain status setting and status inquiries about terminal devices, the functions stty and gity 
are equivalent to 
ioctl (fildes, TIOCSETP, argp) 
ioctl (fildes, TIOCGETP, argp) 


respectively; see rty(4). 
The following two standard calls, however, apply to any open file: 


iocti (fildes, FIOCLEX, NULL): 
iocti (fildes, FIONCLEX, NULL): 


The first causes the file to be closed automatically during a successful exec operation; the 
second reverses the effect of the first. 


The following call is peculiar to the Berkeley implementation, and aiso applies to any open file: 
iocti(fildes, FIONREAD, &count) 
returning, in the longword count the number of characters available for reading from /ldes. 


SEE ALSO 
stty(1), tty(4), exec(2) 


DIAGNOSTICS 
Zero is returned if the call was successful; ~1 if the file descriptor does not refer to the kind of 
file for which it was intended, or if request attempts to modify the state of a terminal when fildes 
is not writeable. 
loctl calls which attempt to modify the state of a process control terminal while a process is not 
in the process group of the control terminal will cause a SIGTTOU signal to be sent to the pro- 
cess’ process group. Such jocr/s are allowed, however, if SIGTTOU is being held, ignored, if 
the process is an orphan which has been inherited by ini, or is the child in an tncomplete vfork 
(see jobs(3)) 

BUGS 
Strictly speaking, since ioctl may be extended in different ways to devices with different proper- 
tres, argp should have an open-ended declaration like 

union { struct sgttyb ...; ....} eargp; 

The important thing is that the size is fixed by ‘struct sgttyb’. 

ASSEMBLER (PDP-11) 
(ioctl = 54.) 
Sys ioctl; fildes; request; argp 
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(stty = 31.) 

(file descriptor in r0) 
stty; argp 

(gtty = 32.) 

(file descriptor in r0) 
Sys gffy; argp 
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NAME 
kill — send signal to a process 


SYNOPSIS 
kill (pid, sig) 


DESCRIPTION 
Kill sends the signal sig to the process specified by the process number pid. See sigsys(2) for a 
list of signals. 


The sending and receiving processes must have the same effective user ID, otherwise this call 
is restricted to the super-user. (A single exception is the signal SIGCONT which may be sent 
as described in killpg(2), although it is usually sent using Aillpg rather than «i/). 


If the process number is 0, the signal is sent to all other processes in the sender's process 
group; see tty(4) and also killpg(2). 


If the process number is ~1, and the user is the super-user, the signal is broadcast universally 
except to processes 0, 1, 2, the scheduler initialization, and pageout processes, and the process 
sending the signal. 


Processes may send signals to themselves. 
SEE ALSO : 
sigsys(2), signal(2), kill(1), killpg(2), init (8) 


DIAGNOSTICS | 
Zero is returned if the process is killed; —1 is returned if the process does not have the same 
effective user ID and the user is not super-user, or if the process does not exist. 


ASSEMBLER (PDP-11) 
(kill = 37.) 
(process number in r0) 
sys kill; sig 
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NAME 


killpg — send signal to a process or a process group 


SYNOPSIS 


killpg (perp, sig) 
ec... ljobs 


DESCRIPTION 


Killpg sends the signal sig to the specified process group. See sigsys(2) for a list of signals: see 
jobs(3) for an explanation of process groups. 


The sending process and members of the process group must have the same effective user ID. 
otherwise this call is restricted to the super-user. As a single special case the continue signal 
SIGCONT may be sent to any process which is a descendant of the current process. This 
allows a command interpreter such as csh(1) to restart set-user-id processes stopped from the 
keyboard with a stop signal. 
The calls 

killpg(0, sig) 
and 

kill(0, sig) 


have identical effects, sending the signal to all members of the invoker’s process group (includ- 
ing the process itself). It is preferable to use the call involving A///in this case, as it is portable 
to other UNIX systems. 


SEE ALSO 


jobs(3), kill(2), sigsys(2), signal(2), csh(1), kill) 


DIAGNOSTICS 


BUGS 


Zero is returned if the processes are sent the signals; —1 is returned if any process in the pro- 
cess group cannot be sent the signal, or if there are no members in the process group. 


The job control facilities are not available in standard version 7 UNIX. These facilities are still 
under development and may change in future releases of the system as better inter-process 
communication facilities and support for virtual terminals become available. The options and 
specifications of this system call and even the call itself are thus subject to change. 
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NAME 
link — link to a file 


SYNOPSIS 
link (namel, name2) 
char enamel, «name2; 


DESCRIPTION 
A link to name/ is created; the link has the name nameZ. Either name may be an arbitrary path 
name. 


SEE ALSO 
In(1), unlink (2) 


DIAGNOSTICS 
Zero is returned when a link is made; —1 is returned when name/ cannot be found; when 
named already exists; when the directory of name2 cannot be written; when an attempt is made 
to link to a directory by a user other than the super-user; when an attempt is made to link to a 
file on another file system; when a file has too many links. | 


On some systems the super-user may link to non-ordinary files. 


ASSEMBLER (PDP-11) 
(link = 9.) 
sys link; namel; name2 
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NAME | | 
Iseek, tell — move read/write pointer 


SYNOPSIS 
long Iseek (fildes, offset, whence) 
long offset; 
long tell (fildes) 

DESCRIPTION 


The file descriptor refers to a file open for reading or writing. The read (resp. write) pointer for 
the file is set as follows: 


If whence is 0, the pointer is set to offset bytes. 
If whence is 1, the pointer is set to its current location plus offset. 
If whence is 2, the pointer is set to the size of the file plus offset. 
The returned value is the resulting pointer location. 
The obsolete function tel/(Vildes) is identical to lseek Vfildes, OL, 1). 


Seeking far beyond the end of a file, then writing, creates a gap or ‘hole’, which occupies no 
physical space and reads as zeros. 

SEE ALSO 
open(2), creat(2), fseek(3) 

DIAGNOSTICS 
—1 is returned for an undefined file descriptor, seek on a pipe, or seek to a position before the 
beginning of file. : 


BUGS 
Lseek is a no-op on character special files. 


ASSEMBLER (PDP-1) 
(Iseek = 19.) 
(file descriptor in r0) 
sys lseek; offset1; offset2; whence 


Offset] and offset2 are the high and low words of offser, r0 and rl contain the pointer upon 
return. 
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NAME 
mknod — make a directory or a special file 


SYNOPSIS 
mknod(name, mode, addr) 
char *name; 


DESCRIPTION 
Mknod creates a new file whose name is the null-terminated string pointed to by mame. The 
mode of the new file (including directory and special file bits) is initialized from mode. (The 
protection part of the mode is modified by the process’s mode mask; see umask(2)). The first 
block pointer of the i-node is initialized from addr. For ordinary files and directories addr is 
normally zero. In the case of a special file, addr specifies which special file. 


Mknod may be invoked only by the super-user. 


SEE ALSO 
mkdir(1), mknod(1), filsys(S) 


DIAGNOSTICS 
Zero is returned if the file has been made; ~—1 if the file already exists or if the user is not the 
super-user. 

ASSEMBLER (PDP-1}1) 


(mknod = 14.) 
sys mknod; name; mode; addr 
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NAME 
mount, umount — mount or remove file system 

SYNOPSIS 
mount(special, name, rwflag) 
char *special, sname; 
umount (special) 
char especial; 

DESCRIPTION 
Mount announces to the system that a removable file system has been mounted on the block- 
structured special file special; from now on, references to file name will refer to the root file on 
the newly mounted file system. Specia/ and name are pointers to null-terminated strings con- 
taining the appropriate path names. 
Name must exist already. Name must be a directory (unless the root of the mounted file system 
is not a directory). Its old contents are inaccessible while the file system is mounted. 
The rwflag argument determines whether the file system can be written on; if it is 0 writing is 
allowed, if non-zero no writing is done. Physically write-protected and magnetic tape file sys- 
tems must be mounted read-only or errors will occur when access times are updated, whether 
or not any explicit write is attempted. 
Umount announces to the system that the specia/ file is no longer to contain a removable file 
system. The associated file reverts to its ordinary interpretation. 

SEE ALSO 
mount(8) 

DIAGNOSTICS 
Mount returns 0 if the action occurred; —1 if special is inaccessible or not an appropriate file; if 
name does not exist; if special is already mounted; if mame is in use, or if there are already too 
many file systems mounted. | 
Umount returns 0 if the action occurred; —1 if if the special file is inaccessible or does not have 
a mounted file system, or if there are active files in the mounted file system. 

BUGS 


If a file containing holes (unallocated blocks) is read, even on a file system mounted read-only, 
the system will attempt to fill in the holes by writing on the device. 


ASSEMBLER (PDP-11) 


(mount = 21.) 
SyS mount; special; name; rwflag 


(umount = 22.) 
SYS umount; special 
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mpx — create and manipulate multiplexed files 


SYNOPSIS 


mpx (name, access) 
char ename; 


join(fd, xd) 

chan (xd) 

extract (i, xd) 
attach (i, xd) 

detach (i, xd) 
connect (fd, ed, end) 
npgrp(i, xd, perp) 
ckill i, xd, signal 


#include <sys/mx.h> 
mpxcall(emd, vec) 
int vec: 


DESCRIPTION 


mpxcall(emd, vec) is the system call shared by the library routines described below. Crd 
selects a command using values defined in <sys/mx.h>. Vecis the address of a structure con- 
taining the arguments for the command. 


mpx (name, access) 


Mpx creates and opens the file name with access permission access (see crear(2)) and returns a 
file descriptor available for reading and writing. A -—1 is returned if the file cannot be created, 
if name already exists, or if the file table or other operating system data structures are full. The 
file descriptor is required for use with other routines. 


If name is 0, a file descriptor is returned as described but no entry is created in the file system. 


Once created an mpx file may be opened (see open(2)) by any process. This provides a form of 
interprocess communication whereby a process B can ‘call’ process A by opening an mpx file 
created by A. To B, the file is ordinary with one exception: the connect primitive could be 
applied to it. Otherwise the functions described below are used only in process A and descen- 
dants that inherit the open mox file. 


When a process opens an mpx file, the owner of the file receives a control message when the 
file is next read. The method for ‘answering’ this kind of call involves using attach and detach 
as described in more detail below. 


Once B has opened A’s mpx file it is said to have a channe/to A. A channel is a pair of data 
streams: in this case, one from B to A and the other from A to B. Several processes may open 
the same mpx file yielding multiple channels within the one mpx file. By accessing the 
appropriate channel, A can communicate with B and any others. When A reads (see read(2)) 
from the mpx file data written to A by the other processes appears in A’s buffer using a record 
format described in mpxio(S). When A writes (see write(2)) on its mpx file the data must be 
formatted in a similar way. 


The following commands are used to manipulate mpx files and channels. 


join adds a new channel on an mpx file to an open file F. I/O on the new channel is 
1/0 on F. 
chan-— creates a new channel. 
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extract— file descriptor maintenance. 

connect— similar to join except that the open file F is connected to an existing channel. 
attach and detach— used with call protocol. 

npgerp— manipulates process group numbers so that a channel can act as a control ter- 
minal (see «ty(4)). 

ckill— send signal (see signa/(2)) to process group through channel. 


A maximum of 15 channels may be connected to an mpx file. They are numbered 0 through 
14. Join may be used to make one mpx file appear as a channel on another mpx file. A hierar- 
chy or tree of mpx files may be set up in this way. In this case one of the mpx files must be 


the root of a tree where the other mpx files are interior nodes. The maximum depth of such a 
tree is 4. 


An index is a 16-bit value that denotes a location in an mpx tree other than the root: the path 
through mpx ‘nodes’ from the root to the location is expressed as a sequence of 4-bit nibbles. 
The branch taken at the root is represented by the low-order 4-bits of an index. Each succeed- 
ing branch is specified by the next higher-order nibble. If the length of a path to be expressed 
is less than 4, then the illegal channel number, 15, must be used to terminate the sequence. 
This is not strictly necessary for the simple case of a tree consisting of only a root node: its 
channels can be expressed by the numbers 0 through 14. An index / and file descriptor xd for 
the root of an mpx tree are required as arguments to most of the commands described below. 
Indices also serve as channel identifiers in the record formats given in mpxio(S). Since —1 1s 


not a valid index, it can be returned as a error indication by subroutines that normally return 
indices. 


The operating system informs the process managing an mpx file of changes in the status of 
channels attached to the file by generating messages that are read along with data from the 
channels. The form and content of these messages is described in mpxio(5). - 


join(fd, xd) establishes a connection (channel) between an mpx file and another object. Fd ts 
an open file descriptor for a character device or an mpx file and xd is the file descriptor of an 
mpx file. Join returns the index for the new channel if the operation succeeds and —1 if it 
does not. 


Following join, fd may still be used in any system call that would have been meaningful before 
the join operation. Thus a process can read and write directly to /d as well as access it via xd. If 
the number of channels required for a tree of mpx files exceeds the number of open files per- 
mitted a process by the operating system, some of the file descriptors can be released using the 
standard close(2) call. Following a close on an active file descriptor for a channel or internal 
mpx node, that object may still be accessed through the root of the tree. 


chan(xd) allocates a channel and connects one end of it to the mpx file represented by file 
descriptor xd. Chan returns the index of the new channel or a —1 indicating failure. The 
extract primitive can be used to get a non-multiplexed file descriptor for the free end of a chan- 
nel created by chan. 


Both chan and join operate on the mpx file specified by xd. File descriptors for interior nodes 
of an mpx tree must be preserved or reconstructed with extract for use with join or chan. For 
the remaining commands described here, xd denotes the file descriptor for the root of an mpx 
tree. 


extract(i, xd) returns a file descriptor for the object with index jon the mpx tree with root file 
descriptor xd. A —1 is returned by extract if a file descriptor is not available or if the arguments 
do not refer to an existing channel and mpx file. | 


attach (i, xd) 3 
detach(i, xd). If a process A has created an mpx file represented by file descriptor xd, then a 
process B can open (see open(2)) the mpx file. The purpose is to establish a channel between 
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FILES 


A and B through the mpx file. A‘rach and Detach are used by A to respond to such opens. 


An open request by B faiis immediately if a new channel cannot be allocated on the mpx file, if - 


the mpx file does not exist, or if it does exist but there is no process (A) with a multiplexed file 
descriptor for the mpx file (i.e. xd as returned by mpx(2)). Otherwise a channel with index 
number jis allocated. The next time A reads on file descriptor xd, the WATCH control mes- 
sage (see mpxio(5)) will be delivered on channel i. A responds to this message with attach or 
detach. The former causes the open to complete and return a file descriptor to B. The latter 
deallocates channel / and causes the open to fail. 


One mpx file may be placed in ‘listener’ mode. This is done by writing joct/(xd, MXLSTN, 0) 
where xd is an mpx file descriptor and MXLSTN is defined in /usr/include/sgtty.h. The semantics 


of listener mode are that all file mames discovered by open(2) to have the syntax . 


system!pathname (see uucp(1)) are treated as opens on the mpx file. The operating system 
sends the listener process an OPEN message (see mpxio(5)) which includes the file name being 
opened. Asiach and detach then apply as described above. 


Detach has two other uses: it closes and releases the resources of any active channel it is applied 
to, and should be used to respond to a CLOSE message (see mpxio(S)) on a channel so the 
channel may be reused. 


connect (fd, ed, end). Fd is a character file descriptor and cd is a file descriptor for a channel, 
such as might be obtained via extract( chan(xd), xd) or by open(2) followed by attach. Connect 
splices the two streams together. If end is negative, only the output of /d is spliced to the input 
of cd. If end is positive, the output of cd is spliced to the input of /a@. If end is zero, then both 
splices are made. 


npgrp(i, xd, perp). If xd is negative npgrp applies to the process executing it, otherwise / and 
xd are interpreted as a channel index and mpx file descriptor and apegrp is applied to the process 
on the non-multiplexed end of the channel. If perp is zero, the process group number of the 
indicated process is set to the process number of that process, otherwise the value of pgrp is 
used as the process group number. 


Npegrp normally returns the new process group number. If j and xd specify a nonexistent chan- 
nel, npgrp returns —1. 


ckill(i, xd, signal) sends the specified signal (see signa/(2)) through the channel specified by / 
and xd. If the channel is connected to anything other than a process, cki/l is a null operation. If 
there is a process at the other end of the channel, the process group will be interrupted (see sigz- 
nal(2), kill(2)). Ckill normally returns signal. If ch and xd specify a nonexistent channel, ckxill 
returns —1. 


/usr/include/sys/mx.h 
/usr/include/sgtty.h 


SEE ALSO 


BUGS 


mpxio(5) 


Mpx files are an experimental part of the operating system more subject to change and prone to 
bugs than other parts. | 


Maintenance programs, e.g. icheck(1), diagnose mpx files as an illegal mode. 


Channels may only be connected to objects in the operating system that are accessible through 
the line discipline mechanism. 


Higher performance line disciplines are needed. 
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The maximum tree depth restriction is not really checked. 
A non-destructive disconnect primitive (inverse of connect) is not provided. 


A non-blocking flow control strategy based on messages defined in mpxio(S) should not be 
attempted by novices; the enabling joct/ command should be protected. 


The join operation could be subsumed by connect. A mechanism is needed for moving a channel! 
from one location in an mpx tree to another. 
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NAME 
nice — set program priority 


SYNOPSIS 
nice (incr) 


DESCRIPTION 


The scheduling priority of the process is augmented by incr. Positive priorities get less service 
than normal. Priority 10 is recommended to users who wish to execute long-running programs 
without flak from the administration. 


Negative increments are ignored except on behalf of the super-user. The priority is limited to 
the range —20 (most urgent) to 20 (least). 


The priority of a process is passed to a child process by /ork(2). For a privileged process to 
return to normal priority from an unknown state, nice should be called successively with argu- 
ments —40 (goes to priority ~—20 because of truncation), 20 (to get to 0), then 0 (to maintain 
compatibility with previous versions of this call). 

SEE ALSO 
nice(1), fork(2), renice(8) 


ASSEMBLER (PDP-11) 
(nice = 34.) 
(priority in r0) 
SYS nice 
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NAME 

open — open for reading or writing 
SYNOPSIS 

open(name, mode) 

char «name; 
DESCRIPTION - 


Open opens the file name for reading (if mode is 0), writing (if mode is 1) or for both reading 
and writing (if mode is 2). Name is the address of a string of ASCII characters representing a 
path name, terminated by a null character. 


The file is positioned at the beginning (byte 0). The returned file descriptor must be used for 
subsequent calls for other input-output functions on the file. 
SEE ALSO | 
creat(2), read(2), write(2), dup(2), close(2) 
DIAGNOSTICS 
The value —1 is returned if the file does not exist, if one of the necessary directories does not | 
exist or is unreadable, if the file is not readable (resp. writable), or if too many files are open. 
ASSEMBLER (PDP-11) 
(open = 5.) 
SYS Open; name; mode 
(file descriptor in r0) 


BUGS 


It should be possible to optionally open files for writing with exclusive use, and to optionally - 


call open without the possibility of hanging waiting for carrier on communication lines. 
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NAME 
pause — stop until signal 


SYNOPSIS 
pause () 

DESCRIPTION 
Pause never returns normally. It is used to give up control while waiting for a signal from 
kill(2) or alarm(2). Upon termination of a signal handler started during a pause, the pause call 
will return. 


SEE ALSO 
kill(1), kill(2), alarm(2), sigsys(2), signal(2), sigset(3), setimp(3) 


ASSEMBLER (PDP-I1) 
(pause = 29.) 
SYS pause 
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NAME 

pipe — create an interprocess channel 
SYNOPSIS 

pipe (fildes) 


int fildes([2]; 


DESCRIPTION 


The pipe system call creates an I/O mechanism called a pipe. The file descriptors returned can 
be used in read and write operations. When the pipe is written using the descriptor fildes{1] up 
to 4096 bytes of data are buffered before the writing process is suspended. A read using the 
descriptor fi/des(0] will pick up the data. 


It is assumed that after the pipe has been set up, two (or more) cooperating processes (created 
by subsequent fork calls) will pass data through the pipe with read and write calls. 


The Shell has a syntax to set up a linear array of processes connected by pipes. 


Read calls on an empty pipe (no buffered data) with only one end (all write file descriptors 
closed) returns an end-of-file. 


SEE ALSO 


sh(1), read(2), write(2), fork(2) 


DIAGNOSTICS 


BUGS 


The function value zero is returned if the pipe was created; —1 if too many files are already 
open. A signal is generated if a write on a pipe with only one end is attempted. 


Should more than 4096 bytes be necessary in any pipe among a loop of processes, deadlock will 
occur. 


ASSEMBLER (PDP-11) 


(pipe = 42.) 

sys pipe 

(read file descriptor in r0) 
(write file descriptor in rl) 
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NAME 
profil — execution time profile 


SYNOPSIS 
profil(buff, bufsiz, offset, scale) 
char *buff; 
int bufsiz, offset, scale; 


DESCRIPTION 
Buff points to an area of core whose length (in bytes) is given by du/fsiz. After this call, the 
user’s program counter (pc) is examined each clock tick (60th second): offset is subtracted from 
it, and the result multiplied by sca/e. If the resulting number corresponds to a word inside buff 
that word is incremented. 


The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 
0177777(8) gives a 1-1 mapping of pc’s to words in buff 077777(8) maps each pair of instruc- 
tion words together. 02(8) maps all instructions onto the beginning of buff (producing a non- 
interrupting core clock). 


Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a du/fsiz of 
0. Profiling is turned off when an exec is executed, but remains on in child and parent both 
after a fork. Profiling may be turned off if an update in buff would cause a memory fault. 


SEE ALSO 
monitor(3), prof) 


ASSEMBLER (PDP-11) 
(profil = 44.) 

sys profil; buff; bufsiz; offset; scale 
BUGS | 
Profiling does not work for interpreters; if a signal were given to a process when its cpu-time 
clock ticked then profiling interpreters would be possible. 
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NAME 
ptrace — process trace 


SYNOPSIS 
#include <signal.h> 


ptrace(request, pid, addr, data) 
int «addr; 


DESCRIPTION 


Ptrace provides a means by which a parent process may control the execution of a child process, 
and examine and change its core image. Its primary use is for the implementation of break- 
point debugging. There are four arguments whose interpretation depends on a request argu- 
ment. Generally, pid is the process ID of the traced process, which must be a child (no more 
distant descendant) of the tracing process. A process being traced behaves normally until it 
encounters some signal whether internally generated like ‘illegal instruction’ or externally gen- 
erated like ‘interrupt.’ See signa/(2) for the list. Then the traced process enters a stopped state 


and its parent is notified via wait(2). When the child is in the stopped state, its core image can 


be examined and modified using ptrace. If desired, another prrace request can then cause the 
child either to terminate or to continue, possibly ignoring the signal. 


The value of the request argument determines the precise action of the call: 


QO This request is the only one used by the child process: it declares that the process is to be 
traced by tts parent. All the other arguments are ignored. Peculiar results will ensue if the 
parent does not expect to trace the child. 


1,2 The word in the child process’s address space at addr is returned. If I and D space are 
separated, request 1 indicates I space, 2 D space. Addr must be even. The child must be 
stopped. The input data is ignored. 


3 The word of the system’s per-process data area corresponding to addr is returned. Addr 
must be even and less than 512. This space contains the registers and other information 
about the process; its layout corresponds to the user structure in the system. 


4,5 The given data is written at the word in the process’s address space corresponding to addr, 
which must be even. No useful value is returned. If I and D space are separated, request 
4 indicates I space, 5 D space. Attempts to write in pure procedure fail if another process 
is executing the same file. 


6 The process’s system data is written, as it is read with request 3. Only a few locations can 
be written in this way: the general registers, the floating point status and registers, and cer- 
tain bits of the processor status word. 


7 The data argument is taken as a signal number and the child’s execution continues at loca- 
tion addr as if it had incurred that signal. Normally the signal number will be either 0 to 
indicate that the signal that caused the stop should be ignored, or that value fetched out of 
the process’s image indicating which signal caused the stop. If addr is (int *)] then execu- 
tion continues from where it stopped. 


The traced process terminates. 


9 Execution continues as in request 7; however, as soon as possible after execution of at 
least one instruction, execution stops again. The signal number from the stop is 
SIGTRAP. (On the PDP-11 and VAX-11 the T-bit is used and just one instruction is exe- 
cuted; on the Interdata the stop does not take place until a store instruction is executed.) 
This is part of the mechanism for implementing breakpoints. 


As indicated, these calls (except for request 0) can be used only when the subject process has 
stopped. The wait call is used to determine when a process stops; in such a case the ‘termina- 
tion’ status returned by wait has the value 0177 to indicate stoppage rather than genuine 
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termination. 


To forestall possible fraud, ptrace inhibits the set-user-id facility on subsequent exec(2) calls. If 
a traced process calls exec, it will stop before executing the first instruction of the new image 
showing signal SIGTRAP. 


On the Interdata 8/32, ‘word’ means a 32-bit word and ‘even’ means 0 mod 4. Ona VAX-11, 
‘word’ also means a 32-bit integer, but the ‘even’ restriction does not apply. 


SEE ALSO 
wait(2), signal(2), adb(1) 


DIAGNOSTICS 
The value —1 is returned if request is invalid, pid is not a traceable process, addr is out of 
bounds, or data specifies an illegal signal number. 


BUGS 
Ptrace is unique and arcane; it should be replaced with a special file which can be opened and 
read and written. The control functions could then be implemented with joci/(2) calls on this 
file. This would be simpler to understand and have much higher performance. 
On the Interdata 8/32, ‘as soon as possible’ (request 7) means ‘as soon as a Store instruction 
has been executed.’ 
The request 0 call should be able to specify signals which are to be treated normally and not 
cause a stop. In this way, for example, programs with simulated floating point (which use ‘ille- 
gal instruction’ signals at a very high rate) could be efficiently debugged. 
The error indication, —1, is a legitimate function value; errno, see intro(2), can be used to 
disambiguate. 
It should be possible to stop a process on occurrence of a system cail; in this way a completely 
controlled environment could be provided. 

ASSEMBLER 
(pirace = 26.) 
(data in r0) 
SYS ptrace; pid; addr; request 
(value in r0) 3 
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NAME 


read — read from file 


SYNOPSIS 


read (fildes, buffer, nbytes) 
char *buffer; 


DESCRIPTION 


A file descriptor is a word returned from a successful open, creat, dup, or pipe call. Buffer is the 
location of ndytes contiguous bytes into which the input will be placed. It is not guaranteed that 
all nbytes bytes will be read; for example if the file refers to a typewriter at most one line will be 
returned. In any event the number of characters read is returned. 


If the returned value is 0, then end-of-file has been reached. 


Unless the reader is ignoring or holding SIGTTIN signals, reads from the control typewriter 
while not in its process group cause a SIGTTIN signal to be sent to the reader’s process group; 
in the former case an end-of-file is returned. 


SEE ALSO 


open(2), creat(2), dup(2), pipe(2), vread(2) 


DIAGNOSTICS 


As mentioned, 0 is returned when the end of the file has been reached. If the read was other- 
wise unsuccessful the return value is —1. Many conditions can generate an error: physical I/O 
errors, bad buffer address, preposterous ndyres, file descriptor not that of an input file. 


| ASSEMBLER (PDP-11) 


BUGS 


(read = 3.) 

(file descriptor in r0) 
sys read; buffer; nbytes 
(byte count in r0) 


It should be possible to call read and have it return immediately without blocking if there is no 
input available. As a single special case, this is currently done on control terminals when the 
reading process has requested SIGTINT signals when input arrives (see :n(4)). 


Processes which have been orphaned by their parents and have been inherited by init(8) never 
receive SIGTTIN signals. Instead read returns with an end-of-file indication. 
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NAME 
reboot — reboot system or halt processor 


SYNOPSIS 
#include <sys/reboot.h> 


reboot (howto) 
int howto; 


DESCRIPTION 

: Reboot is used to cause a system reboot, and is invoked automatically in the event of unrecov- 
erable system failures. Howto is a mask of options passed to the bootstrap program. The sys- 
tem call interface permits only RB_HALT or RB_AUTOBOOT to be passed to the reboot pro- 
gram; the other flags are used in scripts stored on the console storage media, or used in manual 
bootstrap procedures. When none of these options (e.g. RB_AUTOBOOT) is given, the system 
is rebooted from file ‘‘vmunix’’ in the root file system of unit 0 of a disk chosen in a processor 
specific way: on the 11/780 it is specified by a line in the DEFBOO.CMD script on the console 
floppy; on the 11/750 it is determined by the setting of the front panel switch which picks the 
bootstrap device. An automatic consistency check of the disks is then normally performed. 


The bits of Aowfo are: 


RB_HALT 
the processor is simply halted; no reboot takes place. This should be used with caution. 


RB ASKNAME 
Interpreted by the bootstrap program itself, causing it to inquire as to what file should 
be booted. Normally, the system is booted from the file ‘‘xx(0,0)vmunix*’’ without 
asking, where 2xcis determined by a code in register r/0 (which is known as devtype) at 
entry to the bootstrap program. The code corresponds to the major device number of 
the root file system, i.e. ‘‘major(rootdev)’’. Currently, the following values of devrype 
are understood: 


0 hp rm03/rm05/rm80/rp06 massbus disk 

l -- unused 

2 up unibus disks (emulex sc21 w/ cdc/ampex/fujitsu drives) 
3 


rk rkO7 unibus disks 
Thus if 7/0 contained a 2, the system 
up (0,0) vmunix. 
would be booted. This switch not available from the system call interface. 
RB SINGLE 7 
Normally, the reboot procedure involves an automatic disk consistency check and then 
multi-user operations. This prevents the consistency check, rather simply booting the 
system with a single-user shell on the console, from the file system specified by rJ0. 


This switch is interpreted by the ini#(8) program in the newly booted system. This 
switch is not available from the system call interface. 


SEE ALSO 
crash(8), hait(8), init(8), reboot (3) 


BUGS 
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NAME 


setpgrp, getpgrp — set/get process group 


SYNOPSIS 


int getpgrp (pid) 
setpgrp(pid, pgrp) 
cc... ~ljobs 


DESCRIPTION 


The process group of the specified process is returned by gerperp. Setperp sets the process group 
of the specified process pid to the specified perp. If pid is zero, then the call applies to the 
current process. 


If the invoker is not the super-user, then the affected process must have the same effective 
user-id as the invoker or be a descendant of the invoking process. 


This call is used by csh(1) to create process groups in implementing job control. The 
TIOCGPGRP and TIOCSPGRP calls described in ry(4) are used to get/set the process group 
of the control terminal. 


See jobs(3) for a general discussion of job control. | 


SEE ALSO 


BUGS 


jobs(3), getuid(2), tty(4) 


¢@ 


The job control facilities are not available in standard version 7 UNIX. These facilities are still 
under development and may change in future releases of the system as better tnter-process 
communication facilities and support for virtual terminals become available. The options and 
specifications of these system calls and even the calls themselves are thus subject to change. 


A system call setpgrp has been implemented in other versions of UNIX which are not widely 
used outside of Bell Laboratories; these implementations have, in general, slightly different 
semanlics. 
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NAME 
setuid, setgid — set user and group [D 


SYNOPSIS 
setuid (uid) 


setgid (gid) 
DESCRIPTION 
The user ID (group ID) of the current process is set to the argument. Both the effective and 


the real ID are set. These calls are only permitted to the super-user or if the argument is the 
real or effective ID. 


SEE ALSO 
getuid(2) 


DIAGNOSTICS 
Zero is returned if the user (group) ID is set; —1 is returned otherwise. 


ASSEMBLER (PDP-1i1) 
(setuid = 23.) 
(user ID in r0) 
Sys setuid 


(setgid = 46.) 
(group ID in rQ) 
Sys setgid 
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signal — catch or ignore signals 


SYNOPSIS 


#include <signal.h> 


(*signal (sig, fune)) O 
void (*func) 0; 


DESCRIPTION 


N.B.: The system currently supports two signal implementations. The one described here is 
standard in version 7 UNIX systems, and is retained for backward compatabililty. The one 
described in sigsys(2) as supplemented by sigser(3) provides for the needs of the job control 
mechanisms used by csh(1), and corrects the bugs in this older implementation of signals, 
allowing programs which process interrupts to be written reliably. 


A signal is generated by some abnormal event, initiated either by user at a terminal (quit, inter- 
rupt), by a program error (bus error, etc.), or by request of another program (kill). Normally 
all signals cause termination of the receiving process, but a signal call allows them either to be 


ignored or to cause an interrupt to a specified location. Here is the list of signals with names as 
in the include file. 


SIGHUP 1 hangup 
SIGINT 2. ~=interrupt 
SIGQUIT 3". quit 
SIGILL 4+ illegal instruction (not reset when caught) 
SIGTRAP 5* trace trap (not reset when caught) 
SIGIOT 6* [OT instruction 
SIGEMT 7* EMT instruction 
SIGFPE 8* floating point exception 
SIGKILL 9 __ kill (cannot be caught or ignored) 
SIGBUS 1Q* bus error 
SIGSEGV _Il* segmentation violation 
SIGSYS 12* bad argument to system call 
SIGPIPE 13. write on a pipe with no one to read it 
SIGALRM 14° alarm clock 
SIGTERM 15. software termination signal 
16 unassigned 
V.B.: There are actually more signals; see sigsys(2); the signals listed here are those of standard 
version 7. 


The starred signals in the list above cause a core image if not caught or ignored. 


If func is SIG_DFL, the default action for signal sig is reinstated; this default is termination, 
sometimes with a core image. If func is SIG_IGN the signal ts ignored. Otherwise when the 
signal occurs func will be called with the signal number as argument. A return from the func- 
tion will continue the process at the point it was interrupted. 


Except as indicated, a signal is reset to SIG_DFL after being caught. Thus if it is desired to 
catch every such signal, the catching routine must tssue another signal call. 


If, when using this (older) signal interface, a caught signal occurs during certain system calls. 
the call terminates prematurely. In particular this can occur during an jocrl, read, or write(2) on 
a slow device (like a terminal; but not a file); and during pause or wait(2). When such a signal 
occurs, the saved user status is arranged in such a way that when return from the signal- 
catching takes place, it will appear that the system call returned an error status. The user’s pro- 
gram may then, if it wishes, re-execute the call. 
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The value of signa/ is the previous (or initial) value of func for the particular signal. 
After a fork(2) the child inherits all signals. Exec(2) resets all caught signals to default action. 


If a process is using the mechanisms of sigsys(2) and sigser(3) then many of these calls are 
automatically restarted (See sigsys(2) and jobs(3) for details). 

SEE ALSO 
sigsys(2), kill(1), kill(2), ptrace(2), setimp(3), sigset(3) 

DIAGNOSTICS 
The value (int)—1 is returned if the given signal is out of range. 

BUGS 
The traps should be distinguishable by extra arguments to the signal handler, and all hardware 
supplied parameters should be made available to the signal routine. 


If a repeated signal arrives before the last one can be reset, there is no chance to catch it (how- 
ever this is not true if you use sigsvs(2) and sigser(3)). 


The type specification of the routine and its func argument are problematical. 
ASSEMBLER (PDP-11) 
(signal = 48.) 
Sys Signal; sig; label 
(old label in rQ) 
If fabel is 0, default action is reinstated. If /ade/ is 1, the signal is ignored. Any other even 
label specifies an address in the process where an interrupt is simulated. An RTI or RTT 
instruction will return from the interrupt. 


NOTES (VAX-11) 
See sigsys(2) for information on how hardware faults are mapped into signals. 
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sigsyS — catch or ignore signals 


SYNOPSIS 


#include <signal.h> 


(esigsys(sig, func)) O 
void (*func) 0; 


ce ... —ljobs 


DESCRIPTION 3 


N.B.: The system currently supports two signal implementations. The one described in sig- 
nal(2) is standard in version 7 UNIX systems, and retained for backward compatibility as it is 
different in a number of ways. The one described here (with the interface in sigser(3)) pro- 
vides for the needs of the job control mechanisms (see jobs(3)) used by csh(1), and corrects 


the bugs in the standard implementation of signals, allowing programs which process interrupts 
to be written reliably. 


The routine sigsys is not normally called directly; rather the routines of sigser(3) should be 
used. These routines are kept in the ‘‘jobs’’ library, accessible by giving the loader option 
—ljobs. The features described here are less portable then those of signa/(2) and should not be 
used in programs which are to be moved to other versions of UNIX. 


A signal is generated by some abnormal event, initiated by a user at a terminal (quit, interrupt, 
stop), by a program error (bus error, etc.), by request of another program (kill), or when a pro- 
cess is stopped because it wishes to access its control terminal while in the background -(see 
tty(4)). Signals are optionally generated when a process resumes after being stopped, when the 
status of child processes changes, or when input is ready at the control terminal. Most signals 
cause termination of the receiving process if no action is taken; some signals instead cause the 
process receiving thern to be stopped, or are simply discarded if the process has not requested 

otherwise. Except for the SIGKILL and SIGSTOP signals which cannot be blocked, the sigsys 
call allows signals either to be ignored, held until a later time (protecting critical sections in the 
process), or to cause an interrupt to a specified location. Here is the list of all signals with 
names as in the include file. 


SIGHUP 1 hangup 
SIGINT 2 interrupt 


SIGQUIT 3+ quit 

SIGILL 4s illegal instruction (not reset when caught) 
SIGTRAP 5 trace trap (not reset when caught) 
SIGIOT 6« IOT instruction 

SIGEMT 7e EMT instruction 

SIGFPE 8* floating point exception 

SIGKILL 9 _ kill (cannot be caught, held or ignored) 


SIGBUS 10° bus error 
SIGSEGV _1l* segmentation violation 
SIGSYS 12¢ bad argument to system call 
SIGPIPE 13. write on a pipe with no one to read it 
SIGALRM 14 alarm clock 
SIGTERM 15. software termination signal 
16 unassigned 
SIGSTOP 17f stop (cannot be caught, held or ignored) 
SIGTSTP 187 stop signal generated from keyboard 
SIGCONT 19 continue after stop 
SIGCHLD 20@ child status has changed 
SIGTTIN 21+ background read attempted from control terminal 
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SIGTTOU 227 background write attempted to control terminal 
SIGTINT 23 input record is available at control terminal 
SIGXKCPU 24 cpu time limit exceeded (see viimid2)) 
SIGXFSZ 25 file size limit exceeded (see viimid2)) 


The starred signals in the list above cause a core image if not caught, held or ignored. 


If func is SIG_DFL, the default action for signal sig is reinstated; this default is termination 
(with a core image for starred signals) except for signals marked with @ or t. Signals marked 
with ® are discarded if the action is SIG_DFL; signals marked with T cause the process to stop. 
If funcis SIG_HOLD the signal is remembered if it occurs, but not presented to the process; it 
may be presented later if the process changes the action for the signal. If funcis SIG_IGN the 
signal is subsequently ignored, and pending instances of the signal are discarded (i.e. if the 
action was previously SIG_HOLD.) Otherwise when the signal occurs func will be called. 


A return from the function will continue the process at the point it was interrupted. Except as 
indicated, a signal, set with sigsys, is reset to SIG DFL after being caught. However by specify- 
ing DEFERSIG(func) as the last argument to sigsys, one causes the action to be set to 
SIG_HOLD before the interrupt is taken, so that recursive instances of the signal cannot occur 
during handling of the signal. 


When a caught signal occurs during certain system calls, the call terminates prematurely. In 
particular this can occur during a read or write(2) on a slow device (like a terminal; but not a 
file) and during a pause or wait(2). When a signal occurs during one of these calls, the saved 
user status is arranged in such a way that, when return from the signal-catching takes place, it 
will appear that the system call returned an error status. The user’s program may then, if it 
wishes, re-execute the call. Read and write calls which have done no I/O, ioctS blocked with 
SIGTTOU, and wait? calls are restarted. 


The value of sigsysis the previous (or initial) value of func for the particular signal. 


The system provides two other functions by oring bits into the signal number: SIGDOPAUSE 
causes the process to pause after changing the signal action. It can be used to atomically re- 
enable a held signal which was being processed and wait for another instance of the signal. 
SIGDORTI causes the system to simulate an re/instruction clearing the mark the system placed 
on the stack at the point of interrupt before checking for further signals to be presented due to 
the specified change in signal actions. This allows a signal package such as sigser(3) to dismiss 
from interrupts cleanly removing the old state from the stack before another instance of the 
interrupt 1s presented. 


After a fork(2) or vfork(2) the child inherits all signals. ZExec(2) resets all caught signals to 
default action; held signals remain held and ignored signals remain ignored. 


SEE ALSO 
kill(1), ptrace(2), kill(2), jobs(3), sigset(3), setimp(3), tty (4) 


DIAGNOSTICS 
The value BADSIG is returned if the given signal is out of range. 


BUGS 
The job control facilities are not available in standard version 7 UNIX. These facilities are still 
under development and may change in future releases of the system as better inter-process 
communication facilities and support for virtual terminals become available. The options and 
specifications of this facility and the system calls supporting it are thus subject to change. 


Since only one signal action can be changed at a time, it is not possible to get the effect of SIG- 
DOPAUSE for more than one signal at a time. 
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The traps (listed below) should be distinguishable by extra arguments to the signal handler, and 
all hardware supplied parameters should be made available to the signal routine. 
ASSEMBLER (PDP-11) 
(signal = 48.) 
sys signal; sig; label 
(old label in r0) 


If labelis 0, default action is reinstated. If /abe/is 1, the signal is ignored. If /abe/is 3, the sig- 

nal is held. Any other even /ade!l specifies an address in the process where an interrupt is simu- 

lated. If label is otherwise odd, the signal is sent to the function whose address is the label with 

the low bit cleared with the action set to SIG_HOLD. (Thus DEFERSIG is indicated by the 

low bit of a signal catch address. An RTI or RTT instruction will return from the interrupt.) 
NOTES (VAX-11) 

The handler routine can be declared: 


handler(signo, param, xx, pc, psl) 


Here signo is the signal name, into which the hardware faults and traps are mapped as defined 
below. Param is the parameter which is either a constant as given below or, for compatibility 
mode faults, the code provided by the hardware. Compatibility mode faults are distinguished 
from the other SIGILL traps by having PSL_CM set in the psi. 


The routine is actually called with only 3 parameters specified in the calls or callg instruction. 
After return from the signal handler the pe and psi are popped off of the stack with an rei so 
they act as ‘‘value-result’’ parameters unlike normal C value parameters. 


The following defines the mapping of hardware traps to signals and codes. All of these symbols 
are defined in <signal.h>: 


Hardware condition Signal Code 


Arithmetic traps: 


Integer overflow SIGFPE FPE INTOVF_TRAP 
Integer division by zero SIGFPE FPE INTDIV_TRAP 
Floating overflow trap SIGFPE FPE FLTOVF_TRAP 


Floating/decimal division by zero SIGFPE FPE FLTDIV_TRAP 


Floating underflow trap SIGFPE FPE FLTUND_TRAP 
Decimal overflow trap SIGFPE FPE DECOVF_TRAP 
Subscript-range SIGFPE FPE SUBRNG_TRAP 
Floating overflow fault SIGFPE FPE FLTOVF_FAULT 
Floating divide by zero fault SIGFPE FPE FLIDIV FAULTY 
Floating underflow fault SIGFPE FPE FLTUND_FAULT 

Length access control SIGSEGV 

Protection violation SIGBUS 

Reserved instruction SIGILL ILL_RESAD_FAULT 

Customer-reserved instr. SIGEMT 

Reserved operand SIGILL ILL_PRIVIN_ FAULT 

Reserved addressing SIGILL ILL_RESOP_FAULT 

Trace pending SIGTRAP 

Bpt instruction SIGTRAP 

Compatibility-mode SIGILL hardware supplied code 

Chme SIGSEGV 

Chms SIGSEGV 

Chmu SIGSEGV 


Sate Deaele alae Tieteshitian 
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NAME 
stat, fstat — get file status 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


stat(name, buf) 
char *name; 
struct stat «buf; 


fstat(fildes, buf) 
struct stat «buf; 


DESCRIPTION 
Stat obtains detailed information about a named file. Fszat obtains the same information about 
an open file known by the file descriptor from a successful open, creat, dupor pipe(2) call. 


Name points to a null-terminated string naming a file; bufis the address of a buffer into which 
information is placed concerning the file. It is unnecessary to have any permissions at all with 
respect to the file, but all directories leading to the file must be searchable. The layout of the 
structure pointed to by buf as defined in < staz.h> is given below. St_mode is encoded accord- 
ing to the ‘#define’ statements. 


/* stat. 4.2 81/02/19 +/ 
struct Stat 

dev t st_ dev; 

ino_t st_ino; 

unsigned short st_mode; 

short st_nlink; 

short st_uid; 

short st_gid; 

dev _t st_rdev; 

off t st_size; 

lime_t —_ st_atime; 

ume_t st_mume; 

time_t st_ctime; 
iE 
#define S_IFMT 0170000 /* type of file */ 
#define S_IFDIR 0040000 /= directory */ 
#define S IFCHR 0020000 /* character special */ 
#define S_IFBLK 0060000 /s biock special / 
#define S_IFREG 0100000 /* regular »/ 
#define S_IFMPC 0030000 /»* multiplexed char special */ 
#define S IFMPB 0070000 /* multiplexed block special ¢/ 
#define S_ISUID 0004000 /* set user id on execution */ 
#define S_ISGID 0002000 /* set group id on execution */ 
#define S_ISVTX 0001000 /* save swapped text even after use «/ 
#define S_IREAD 0000400 /* read permission, owner °/ 
#define S_IWRITE 0000200 /* write permission, owner ¢/ 
#define S_IEXEC 0060100 /e execute/search permission, owner */ 
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The mode bits 0000070 and 0000007 encode group and others permissions (see chmod(2)). 
The defined types, ino_t, off t, time_t, name various width integer values; dev_tencodes major 
and minor device numbers; their exact definitions are in the include file <sys/types.h> (see 
types(5)). 


When /fildes is associated with a pipe, /stat reports an ordinary file with an i-node number, res- 
tricted permissions, and a not necessarily meaningful length. 


st_atime is the file was last read. For reasons of efficiency, it is not set when a directory is 
searched, although this would be more logical. szt_mtime is the time the file was last written or 


created. It is not set by changes of owner, group, link count, or mode. st_ctime is set both 
both by writing and changing the i-node. 


SEE ALSO 


Is(1), filsys(5) 


DIAGNOSTICS 


Zero is returned if a status is available. —1 if the file cannot be found. 


ASSEMBLER 


(stat = 18.) 
sys stat; name; buf 


(fstat = 28.) 
(file descriptor in r0) 
sys fstat; buf 
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NAME 
stime — set time 
SYNOPSIS 
stime(tp) 
long *tp; 
DESCRIPTION 
Stime sets the system’s idea of the time and date. Time, pointed to by fg, is measured in 
seconds from 0000 GMT Jan 1, 1970. Only the super-user may use this call. 


SEE ALSO 
date(1), time(2), ctime(3) 


DIAGNOSTICS 
Zero is returned if the time was set; —1 if user is not the super-user. 


ASSEMBLER (PDP-11) 
(stime = 25.) 
(time in r0-r1) 
sys stime 
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NAME 
sync — update super-block 
SYNOPSIS 
sync() 
DESCRIPTION | 
Sync causes all information in core memory that should be on disk to be written out. This 
includes modified super blocks, modified i-nodes, and delayed block I/O. 


It should be used by programs which examine a file system, for example icheck, df, etc. It is 
mandatory before a boot. 
SEE ALSO 
sync(1), update(8) 
BUGS 
The writing, although scheduled, is not necessarily complete upon return from synic. 
ASSEMBLER (PDP-11) 
(sync = 36.) 
sys sync 
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NAME | 
syscall — indirect system call 


SYNOPSIS 
syscall(number, r0, ri, arg...) (PDP-11) 
syscall(number, arg, ...) (VAX-11) 


DESCRIPTION | 
Syscall performs the system call whose assembly language interface has the specified number, 
register arguments r0 and r/ (on the PDP-11, regardless of whether the entry point really uses 
them) and further arguments arg. 


The r0 value of the system call is returned. 


DIAGNOSTICS 
When the C-bit is set, syscall returns —1 and sets the external variable errno (see intro(2)). 


BUGS 
There is no way to simulate system calls such as pipe(2), which return values in register rl. 


ASSEMBLER (PDP-11) 
(indir = 0.) 
sys indir; call 
The systern call at the location cal! is executed. Execution resumes after the indir call. 
On the PDP-1I1, the main purpose of indir is to allow a program to store arguments in system 
calls and execute them out of line in the data segment. This preserves the purity of the text 
segment. 


If indir is executed indirectly, it is a no-op. If the instruction at the indirect location is not a 
system call, indir returns error code EINVAL: see :miro(2). 
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NAME | 
time, ftime — get date and time 


SYNOPSIS 
long time (0) 


long time(tloc) 
long *tloc; 


#include <sys/types.h> 
#include <sys/timeb.h> 
ftime (tp) 

Struct timeb «tp; 


DESCRIPTION 
Time returns the time since 00:00:00 GMT, Jan. 1, 1970, measured in seconds. 


If foc is nonnull, the return value is also stored in the place to which ¢/oc points. 
The /time entry fills in a structure pointed to by its argument, as defined by <sys/timeb.h>: 
/s timeb.h 3.26/6/80+/ 


/« 
+ Structure returned by ftime system call 
«/ 
struct timeb 

time_t time; 

unsigned short millitm; 

short timezone; 

short dstflag; 
}; 
The structure contains the time since the epoch in seconds, up to 1000 milliseconds of more- 
precise interval, the local time zone (measured in minutes of time westward from Greenwich), 
and a flag that, if nonzero, indicates that Daylight Saving time applies locally during the 
appropriate part of the year. 


SEE ALSO 
date(1), stime(2), ctime(3) 


ASSEMBLER (PDP-11) 
(ftime = 35.) 
sys ftime; bufptr 
(time = 13.; obsolete call) 


Sys time 
(time since 1970 in r0-r1) 
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NAME 
times — get process times 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/times.h> 


times (buffer) 
Struct tms *buffer: 


DESCRIPTION | 
Times returns time-accounting information for the current process and for the terminated child 
processes of the current process. All times are in |/HZ seconds, where HZ is either 50 or 60 
depending on your locality. ; 


This is the structure returned by times: 


/* times.h 4.1 11/9/80 «/ 
|x 
 » Structure returned by times() 
af 
Struct tms | 
| time_t tms_utime; /* user time */ 
time_t tms_stime; /* system time */ 
time_t tms_cutime; /* user time, children */ 
time_t tms_cstime; /* system time, children +/ 


The children times are the sum of the children’s process times and their children’s times. 


SEE ALSO | 
—time(1), time(2), vtimes(2) 


ASSEMBLER (PDP-11) 
(times = 43.) 
sys times; buffer 
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NAME | 

umask — set file creation mode mask 
SYNOPSIS 

umask (comp! mode) 
DESCRIPTION 


Umask sets a mask used whenever a file is created by crear(2) or mknod(2): the actual mode 
(see chmod(2)) of the newly-created file is the logical and of the given mode and the comple- 
ment of the argument. Only the low-order 9 bits of the mask (the protection bits) participate. 
In other words, the mask shows the bits to be turned off when files are created. 


The previous value of the mask is returned by the call. The value is initially 022 (write access 
for owner only). The mask is inherited by child processes. 


SEE ALSO 
creat(2), mknod(2), chmod(2) 


ASSEMBLER (PDP-11) 
(umask = 60.) 
sys umask; compl mode 
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NAME 
unlink — remove directory entry 


SYNOPSIS 
unlink (name) 
char *name; 


DESCRIPTION 
Name points to a null-terminated string. Unlink removes the entry for the file pointed to by 
name from its directory. If this entry was the last link to the file, the contents of the file are 
freed and the file is destroyed. If, however, the file was open in any process, the actual des- 
truction is delayed until it is closed, even though the directory entry has disappeared. 


SEE ALSO 
rm(1), link (2) 


DIAGNOSTICS 
Zero is normally returned; —1 indicates that the file does not exist, that its directory cannot be 
written, or that the file contains pure procedure text that is currently in use. Write permission 
is not required on the file itself. It is also illegal to unlink a directory (except for the super- 
user). 


ASSEMBLER (PDP-11) 
(unlink = 10.) 
sys unlink; name 
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NAME 
utime — set file times 
SYNOPSIS 
#include <sys/types.h> 
utime (file, timep) 
char *file; 
time_t timep/2]; 
DESCRIPTION | 
The utime call uses the ‘accessed’ and ‘updated’ times in that order from the timep vector to set 
the corresponding recorded times for fle. 


The caller must be the owner of the file or the super-user. The ‘inode-changed’ time of the file 
is set to the current time. 

SEE ALSO 
stat (2) 


ASSEMBLER (PDP-11) 
(utime = 30.) 
sys utime; file; timep 
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NAME . 
vadvise — give advice to paging system 
SYNOPSIS 
vadvise (param) 
DESCRIPTION 
Vadvise is used to inform the system thet process paging behavior merits special consideration. 
Parameters to vadvise are defined in the file <vadvise.h> . Currently, two calls to vadvise are 
implemented: 
The call 
vadvise(VA_ ANOM); 
advises that the paging behavior ts not likely to be well handled by the system’s default algo- 
rithm, since reference information collected over macroscopic intervals (e.g. 10-20 seconds) 
will not serve to indicate future page references. The system in this case will choose to replace 
pages with little emphasis placed on recent usage, and more emphasis on referenceless circular 
behavior. It is essential that processes which have very random paging behavior (such as LISP 
during garbage collection of very large address spaces) call vadvise, as otherwise the system has 
great difficulty dealing with their page-consumptive demands. 
The call 
vadvise(VA_ NORM); 
restores default paging replacement behavior after a cali to 
vadvise(VA_ ANOM); | 
BUGS 
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This call is peculiar to this version of UNIX. The options and specifications of this system call 
and even the call itself are expected to change. It is expected to be extended with additional 
facilities in future versions of the system. In particular it is expected that this call will be par- 
ticular to a segment, and that other behaviors such as sequential behavior will be specifiable. 
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NAME 


vfork — spawn new process in a virtual memory efficient way 


SYNOPSIS 


vforkO 


DESCRIPTION 


Vfork can be used to create new processes without fully copying the address space of the old 
process, which is horrendously inefficient in a paged environment. It is useful when the pur- 
pose of fork(2) would have been to create a new system context for an exec. Vfork differs from 
fork in that the child borrows the parent’s memory and thread of control until a call to exec(2) 


or an exit (either by a call to exir(2) or abnormally.) The parent process is suspended while the 
child is using its resources. 


Vfork returns 0 in the child’s context and (later) the pid of the child in the parent's context. 


Vfork can normally be used just like fork. It does not work, however, to return while running in 
the childs context from the procedure which called vfork since the eventual return from vfork 
would then return to a no longer existent stack frame. Be careful, also, to call _exirtrather than 
exit if you can’t exec, since exit will flush and close standard I/O channels, and thereby mess up 
the parent processes standard I/O data structures. (Even with fork it is wrong to call exit since 
buffered data would then be flushed twice.) 


Similarly when using the new signal mechanism of sigser(3) mechanism be sure to call sigsys 
rather than signal(2). 


SEE ALSO 


fork(2), exec(2), sigsys(2), wait(2), 


DIAGNOSTICS 


BUGS 


Same as for fork. 


This system call may be unnecessary if the system sharing mechanisms allow fork to be imple- 
mented more efficiently; users should not depend on the memory sharing semantics of vfork as 
it could, in that case, be made synonymous to fork. 


To avoid a possible deadlock situation, processes which are children in the middle of a vfork are 
never sent SIGITTOU or SIGTTIN signals; rather, output or joctS are allowed and input 
attempts result in an end-of-file indication. 


This call is peculiar to this version of UNIX. 
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NAME 
vhangup — virtually ‘“‘hangup”’ the current control terminal 


SYNOPSIS 
vhangupQ) 


DESCRIPTION 
Vhangup is used by the initialization process init(8) to arrange that users are given ‘‘clean’”’ ter- 
minals at login, by revoking access of the previous users’ processes to the terminal. To effect 
this, vhangup searches the system tables for references to the control terminal of the invoking 
process, revoking access permissions on each instance of the terminal which it finds. Further 
attempts to access the terminal by the affected processes will yield i/o errors (EBADF). 
Finally, a hangup signal (SIGHUP) is sent to the process group of the control terminal. 


SEE ALSO 
init (8) 
BUGS | 
Access to the control terminal via /dev/tty is still possible. 


This call is peculiar to this version of UNIX. The options and specifications of this system call 
and even the call itself are subject to change. 
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NAME 


vlimit — control maximum system resource consumption 


SYNOPSIS 


#include <sys/vlimit.h> 
viimit (resource, value) 


DESCRIPTION 


Limits the consumption by the current process and each process it creates to not individually 
exceed value on the specified resource. If value is specified as —1, then the current limit is 
returned and the limit is unchanged. The resources which are currently controllable are: 
LIM_NORAISE 


A pseudo-limit; if set non-zero then the limits may not be raised. Only the 
| super-user may remove the oraise restriction. 
LIM_CPU the maximum number of cpu-seconds to be used by each process 
LIM_FSIZE _ the largest single file which can be created 


LIM_DATA _ the maximum growth of the data+stack region via sbrk(2) beyond the end of 
the program text 


LIM_STACK the maximum size of the automatically-extended stack region 
LIM_CORE the size of the largest core dump that will be created. 


LIM_MAXRSS 


a soft limit for the amount of physical memory (in bytes) to be given to the 
program. If memory is tight, the system will prefer to take memory from 
processes which are exceeding their declared LIM MAXRSS. 


Because this information is stored in the per-process information this system call must be exe- 
cuted directly by the shell if it is to affect all future processes created by the shell: Jimiris thus a 
built-in command to csh(1). 


The system refuses to extend the data or stack space when the limits would be exceeded in the 
normal way; a break call fails if the data space limit is reached, or the process is killed when the 
stack limit is reached (since the stack cannot be extended, there is no way to send a signal!). 


A file i/o operation which would create a file which is too large will cause a signal SIGXFSZ to 
be generated, this normally terminates the process, but may be caught. When the cpu time 
limit is exceeded, a signal SIGXCPU is sent to the offending process; to allow it time to process 
the signal it is given 5 seconds grace by raising the cpu time limit. 


SEE ALSO 


BUGS 


esh(1) 


If LIM_NORAISE is set, then no grace should be given when the cpu time limit is exceeded. 
There should be limitand unlimitcommands in sh(1) as well as in csh. 


This call is peculiar to this version of UNIX. The options and specifications of this system call 
and even the call itself are subject to change. It may be extended or replaced by other facilities 
in future versions of the system. 
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>. NAME 


vread - read virtually 


SYNOPSIS 


vread(fildes, buffer, nbytes) 
char buffer; 


DESCRIPTION 


SEE ALSO 


N.B.: This call is likely to be replaced by more general virtual memory facilities in the near 
future. 


A file descriptor is a word returned from a successful open, creat, dup or pipe call. Buffer is the 
location of ndyfes contiguous bytes into which the input will be placed. It is not guaranteed that 
all ndvtes will be read (see read(2)). In particular, if the returned value is 0, then end-of-file 
has been reached. 


Unlike read(2), vread does not necessarily or immediately fetch the data requested from fides, 
but merely insures that the data will be fetched from the file descriptor sometime before the first 
reference to the data, at the system’s discretion. Thus vread allows the system, among other 
possibilities, to choose to read data on demand, with whatever granularity is allowed by the 


memory management hardware, or to just read it in immediately as with read. A companion 


vwrite(2) call may be used with vread to provide an efficient mechanism for updating large files. 
The behavior of vread if other processes are writing to //des is not defined. 


Both the address of buffer and the current offset in Al/des (as told by sell{2)) must be aligned to 
a multiple of VALSIZ (defined in <valign.h> ). The library routine va/ioc(3) allocates prop- 
erly aligned blocks from the free list. 


Note for non-virtual systems: the vread system call can be simulated (exactly. if less efficiently) 
by read. If the unit on which a vread is done is not capable of supporting efficient demand ini- 
tialization (e.g. a terminal or a pipe), then the system may choose to treat a call to vread as if it 
were a call to read at its discretion. 


read(2), write(2), vwrite (2), valloc(3) 


. -. DIAGNOSTICS 


_. BUGS 


A 0 is returned at end-of-file. If the read was otherwise unsuccessful, a -1 is returned. Physi- 
cal 1/O errors, non-aligned or bad buffer addresses, preposterous ndyres, file descriptor not that 
of an input file, and file offset not properly aligned can all generate errors. 


You can’t close a file descriptor which you have vread from while there are still pages in the file 


which haven’t been fetched by the system into your address space. In no case can a file 
descriptor which had such pages at the point of a vfork be closed during the vfork. 


The system refuses to truncate a file to which any process has a pending vread. 


There is no primitive inverting vread to release the binding vread sets up so that the file may be 
closed. This can be only be done, clumsily, by reading another (plain) file onto the buffer area, 
or pulling the break back with break(2) to completely release the pages. 


This cail is peculiar to this version of UNIX. It will be superseded by more general virtual 
memory facilities in future versions of the system. 
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NAME | 
vswapon — add a swap device for interleaved paging/swapping 
SYNOPSIS 
yswapon (name) 
char *name; 
DESCRIPTION 
Vswapon makes the argument block device available to the system for allocation for paging and 
swapping. The number of blocks to be made available, as well as the names of all potentially 


available devices are known to the system, and are present in the system configuration file (e.g. 
/usr/sre/sys/conf/confhp.c). 


SEE ALSO 
swapon(8) | 


BUGS 
There is no way to stop swapping on a disk so that the pack may be dismounted. 
This call is peculiar to this version of UNIX. 
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NAME 
viimes — get information about resource utilization 


SYNOPSIS 
vtimes(par_vm, ch_vm) 
struct vtimes *par_vm, *ch_vm; 
DESCRIPTION 
Viimes returns accounting information for the current process and for the terminated child 


processes of the current process. Either par_vm or ch_vm or both may be 0, in which case only 
the information for the pointers which are non-zero is returned. 


After the call, each buffer contains information as defined by the contents of the include file 
/usrlincludelsys/vtimes.h: 


struct vtimes { 


int vm_utime; /* user time (*HZ) «/ 
int vm_stime; /* system time (*HZ) +/ 
/+ divide next two by utime+stime to get averages */ 
unsigned vm_idsrss; /* integral of d+s rss */ 
unsigned vm_ixrss; /« integral of text rss */ 
int vm_maxrss; /* maximum rss */ 

int vm_miajfit; /* major page faults «/ 
int vm_minifit; /« minor page faults */ 
int vm_nswap; /* number of swaps «/ 
int vm_inblk; /* block reads =/ 

int vm_oublk; /e« block writes */ 


P 

The vm_utime and vm_stime fields give the user and system time respectively in 60ths of a 
second (or 50ths if that is the frequency of wall current in your locality.) The vwm_idrss and 
vm_ixrss Measure memory usage. They are computed by integrating the number of memory 
pages in use each over cpu time. They are reported as though computed discretely, adding the 
current memory usage (in 512 byte pages) each time the clock ticks. If a process used 5 core 
pages over | cpu-second for its data and stack, then vm_idsrss would have the value 5+60, where 
vm_utime +vm_stime would be the 60. Vm_idsrss integrates data and stack segment usage, while 
vm_ixrss integrates text segment usage. Vm_maxrss reports the maximum instantaneous sum of 
the text+data+stack core-resident page count. 


The vm_majflt field gives the number of page faults which resulted in disk activity; the 
vm _minflt field gives the number of page faults incurred in simulation of reference bits; 
vm_nswap is the number of swaps which occurred. The number of file system input/output 
events are reported in wm_indb/k and vm_oublk These numbers account only for real i/o; data 
supplied by the caching mechanism is charged only to the first process to read or write the data. 


SEE ALSO 
time(2), wait3(2) 

BUGS 
This call is peculiar to this version of UNIX. The options and specifications of this system call 
are subject to change. It may be extended to include additional information in future versions 
of the system. 
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NAME 


vwrite — write (virtually) to file 


SYNOPSIS 


vwrite(filedes, buffer, nbytes) 
char «buffer; 


DESCRIPTION : 


N.B.: This call is likely to be replaced by more general virtual memory facilities in the near 
future. | 


The vwrite system call is used in conjunction with vread to perform efficient updating of large 
files. After a call to vread and updating of the data in the buffer which was given to vread, a 
vwrite of the same buffer to the same fi/edes at the same offset in the file will cause data which 
has been modified since it was vread from (or vwritten to) the file to be returned to the file. 


SEE ALSO 


vread (2) 


DIAGNOSTICS 


BUGS 
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Returns —1 on error: bad descriptor, buffer address, count or alignment as well as on physical 
I/O errors. 


The result of vwrite is defined only when no other vread's have occurred on buffer since the one 
matching the vwrite. 


This call is peculiar to this version of UNIX. It will be superseded by more general virtual 
memory facilities in future versions of the system. 
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NAME 
wait — wait for process to terminate 


SYNOPSIS 
wait (status) 
int *status; 


wait (0) 


DESCRIPTION 
Wait causes its caller to delay until a signal is received or one of its child processes terminates. 
If any child has died since the last wast, return is immediate; if there are no children, return is 
immediate with the error bit set (resp. with a value of —1 returned). The normal return yields 
the process ID of the terminated child. In the case of several children several wast calls are 
needed to learn of all the deaths. 


If (int) status is nonzero, the high byte of the word pointed to receives the low byte of the argu- 
ment of exit when the child terminated. The low byte receives the termination status of the 
process. See signa/l(2) for a list of termination statuses (signals); 0 status indicates normal ter- 
mination. A special status (0177) is returned for a stopped process which has not terminated 
and can be restarted. See ptrace(2). If the 0200 bit of the termination status is set, a core 
image of the process was produced by the system. 


If the parent process terminates without waiting on its children, the initialization process (pro- 
cess ID = |) inherits the children. 


There is another entry wait3(2) which is provides additional options needed by the shell cs/(1) 
to do job control. 


SEE ALSO 
wait3(2), exit(2), fork(2), signal(2) 


DIAGNOSTICS 
Returns —1 if there are no children not previously waited for. 


ASSEMBLER (PDP-11) 
(wait = 7.) 
SYS wait 
(process ID in r0) 
(status in rl) 


The high byte of the status is the low byte of r0 in the child at termination. 


7th Edition 2-68 


are 


WAIT3 (2J) UNIX Programmer’s Manual WAIT3 (25) 


NAME 


wait3 — wait for process to terminate 


SYNOPSIS 


#include <wait.h> 
#include <sys/vtimes.h> 


wait3(status, options, vtimep) 
union wait status; 

int options; 

struct vtimes *vtimep; 


cc ... Ijobs 


DESCRIPTION 


The status and option words are described by definitions and macros in the file <wait.h>; the 
union and its bitfield definitions and associated macros given there provide convenient and 
mnemonic access to the word of status returned by a wavst3 call. See this file for more informa- 
tion. 


There are two options, which may be combined by oring them together. The first is 
WNOHANG which causes the wait? to not hang if there are no processes which wish to report 
Status, rather returning a pid of 0 in this case as the result of the wait3?. The second option is 
WUNTRACED which causes wait? to return information when children of the current process 
which are stopped but not traced (with ptrace(2)) because they received a SIGTTIN, 
SIGTTOU, SIGTSTP or SIGSTOP signal. See sigsys(2)) for a description of these signals. 


The vtimep pointer is an optional structure where a vtimes Structure is returned describing the 
resources used by the terminated process and all its children. This may be given as ‘‘0”’ if the 
information is not desired. Currently this information is not available for stopped processes. 


SEE ALSO 


wait(2), exit(2), fork(2), sigsys(2) 


DIAGNOSTICS 


BUGS 


Returns —1 if there are no children not previously waited for, or 0 if the WNOHANG option is 
given and there are no stopped or exited children. 


This call is peculiar to this version of UNIX. The options and specifications of this system call 
and even the call itself are subject to change. It may be replaced by other facilities in future 
versions of the system. 
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NAME 
write — write on a file 


SYNOPSIS 
write(fildes, buffer, nbytes) 
char ebuffer; 


DESCRIPTION ; 
A file descriptor is a word returned from a successful open, creat, dup, or pipe(2) call. 


Buffer is the address of nbyrtes contiguous bytes which are written on the output file. The 
number of characters actually written is returned. It should be regarded as an error if this is 
not the same as requested. 


Writes which are multiples of 1024 characters long and begin on a 1024-byte boundary in the 
file are more efficient than any others. 


Writes to the control terminal by a process which is not in the process group of the termainl 
and which is not ignoring or holding SIGTTOU signals cause the writer’s process group to 
receive a SIGTTOU signal (See jods(3) and the description of the LTOSTOP option in :ty(4) 
for details). 


On some systems write clears the set-user-id bit on a file. This prevents penetration of system 
security by a user who “‘captures’’ a writeable set-user-id file owned by the super-user. 


SEE ALSO 
creat(2), open(2), pipe(2) 


DIAGNOSTICS 
Returns —1 on error: bad descriptor, buffer address, or count, physical [/O errors. 


ASSEMBLER (PDP-11) 
(write = 4.) 
(file descriptor in r0) 
sys write; buffer; nbytes 
(byte count in r0) 
BUGS 
It would be nice to be able to call write and have the call return with an error indication if there 
was no buffer space for the written data, rather than blocking the process. 


Processes which have been orphaned by their parents and have been inherited by init(8) never 
receive SIGTTOU signals. Output by such a process is permitted even when they are not in the 
process group of the control terminal. 
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intro — introduction to library functions 


SYNOPSIS 


#include <stdio.h> 
#include <math.h> 
DESCRIPTION ) | 
This section describes functions that may be found tn various libraries, other than those func- 


tions that directly invoke UNIX system primitives, which are described in section 2. Functions 
are divided into various libraries distinguished by the section number at the top of the page: 


(3) These functions, together with those of section 2 and those marked (3S), constitute 
library /ibc, which is automatically loaded by the C compiler cc(1) and the Fortran com- 
piler /77(i). The link editor /d(1) searches this library under the ‘—Ic’ option. Declara- 
tions for some of these functions may be obtained from include files indicated on the 
appropriate pages. 

(3J) These functions are part of the job control facilities, contained in the library ‘‘—Ijobs.”” 
The job control facilities are outlined in jobs(3). 

(3M) These functions constitute the math library, /ibm. They are automatically loaded as 
needed by the Fortran compiler /77(1). The link editor searches this library under the 
‘—Im’ option. Declarations for these functions may be obtained from the include file 
<math.h>. 

(3S) These functions constitute the ‘standard I/O package’, see sdio(3). These functions are 
in the library libc already mentioned. Declarations for these functions may be obtained 
from the include file <stdio.h>. 

(3X)* Various specialized libraries have not been given distinctive captions. Files in which 
such libraries are found are named on appropriate pages. 

FILES | 

/lib/libc.a 

/lib/libm.a, /usr/lib/libm.a (one or the other) 

/usr/lib/libjobs.a 

SEE ALSO 


stdio(3), nm(1), Id(1), ce(1), £77(1), intro(2) 


' DIAGNOSTICS 

Functions in the math llorary (3M) may return conventional values when the function is 
undefined for the giver arguments or wiien (he value is riot representable. In these cases the 
external variable errno (See intro(2)) is set to the value EDOM or ERANGE. The values of 
EDOM and ERANGE are defined in the include file <math.A>. 


ASSEMBLER (PDP-11) 
In assembly language these functions may be accessed by simulating the C calling sequence. 
For example, ecvt(3) might be called this way: 


setd 

mov $sign, — (sp) 
mov  Sdecpt,—(sp) 
mov _ ndigit, — (sp) 
movf value, — (sp) 
jsr pe, _ecvt 

add $14..sp 
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NAME 
abort — generate a fault 


DESCRIPTION 
Abort executes an instruction which is illegal in user mode. This causes a signal that normally 
terminates the process with a core dumip, which may be used for debugging. 

SEE ALSO 
adb(1), signal(2), exit(2) 


DIAGNOSTICS 
Usually ‘IOT trap — core dumped’ from the shell. 
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NAME 
abs — integer absolute value 


SYNOPSIS 
abs (i) 
int i; 
DESCRIPTION 
Abs returms the absolute value of its integer operand. 


SEE ALSO 
floor(3) for fabs 


BUGS 
You get what the hardware gives on the smallest integer. 


Pq he TT Ales mom 
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NAME 
assert ~ program verification 


SYNOPSIS 
#include <assert.h> 


assert (expression) 


DESCRIPTION 
Assert is a macro that indicates expression is expected to be true at this point in the program. It 
causes an exit(2) with a diagnostic comment on the standard output when expression is false (0). 
Compiling with the cc(1) option ~DNDEBUG effectively deletes assert from the program. 


DIAGNOSTICS 
‘Assertion failed: file fline n.’ F is the source file and nm the source line number of the assert 
Statement. 
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NAME 
atof, atoi, atol — convert ASCII to numbers 
SYNOPSIS 


double atof(nptr) 
char *nptr; 
atoi(nptr) 
char enptr; 
long atol(nptr) 
char *nptr; 
DESCRIPTION : 
These functions convert a string pointed to by aprr to floating, integer, and long integer 
representation respectively. The first unrecognized character ends the stririg. 


Atof recognizes an optional string of tabs and spaces, then an optional sign, then a string of 
digits optionally containing a decimal point, then an optional ‘e’ or ‘E’ followed by an optionally 
signed integer. 7 


Atoi and ato! recognize an optional string of tabs and spaces, then an optional sign, then a string 
of digits. 


SEE ALSO 
scanf(3) 


BUGS 
There are no provisions for overflow. 
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NAME 
crypt, setkey, encrypt ~— DES encryption 


SYNOPSIS 
char ecrypt(key, salt) 
char ekey, «salt; 


setkey (key) 
char *key; 


encrypt (block, edflag) 
char *block; 


DESCRIPTION 
Crypt is the password encryption routine. It 1s based on the NBS Data Encryption Standard, 
with variations intended (among other things) to frustrate use of hardware implementations of 
the DES for key search. 


The first argument to crypt fs a user’s typed password. The second is a 2-character string 
chosen from the set [a-zA-Z0-9./]. The sale string is used to perturb the DES algorithm in one 
of 4096 different ways, after which the password is used as the key to encrypt repeatedly a con- 
stant string. The returned value points to the encrypted password, in the same alphabet as the 


salt. The first two characters are the salt itself, 


The other entries provide (rather primitive) access to the actual DES algorithm. The argument 
of setkey is a character array of length 64 containing only the characters with numerical value 0 
and 1. If this string is divided into groups of 8, the low-order bit in each group is ignored, 
leading to a 56-bit key which is set into the machine. | 
The argument to the encrypt entry is likewise a character array of length 64 containing 0's and 
l’s. The argument array is modified in place to a similar array representing the bits of the argu- 
ment after having been subjected to the DES algorithm using the key set by serkey. If edffag is 
0, the argument is encrypted; if non-zero, it ts decrypted. 
SEE ALSO a 
passwd(1), passwd(5), login(1), getpass(3) 
BUGS ; | | . 
The return value points to static data whose content is overwritten by each call. 
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NAME 
ctime, localtime, gmtime, asctime, timezone — convert date and time to ASCII 
SYNOPSIS 


char *ctime(clock) 
long clock; 


#include <time.h> 

struct tm *localtime (clock) 

long *clock; 

struct tm «gmtime (clock) 

long eclock; 

char *asctime(tm) 

struct tm *tm: 

char *timezone(zone, dst) 
DESCRIPTION 


Ctime converts a time pointed to by clock such as returned by time(2) into ASCII and returns a 
pointer to a 26-character string in the following form. All the fields have constant width. 


Sun Sep 16 01:03:52 1973\n\0 


Localtime and gmtime return pointers to structures containing the broken-down time. Localtime 
corrects for the time zone and possible daylight savings time; gmtime converts directly to GMT, 
which is the time UNIX uses. Asctime converts a broken-down time to ASCII and returns a 
pointer to a 26-character string. 


The structure declaration from the include file is: 
Struct tm { /* see ctime(3) +/ 


int tm_sec; 
int trm_min; 
int tm_hour; 
int tm_mday; 
int tm_mon,; 
int tm_year, 
int tm_wday; 
int tm_yday; 
int tm_isdst; 


a 
These quantities give the time on a 24-hour clock, day of month (1-31), month of year (0-11), 


day of week (Sunday = 0), year — 1900, day of year (0-365), and a flag that is nonzero if day- 
light saving time is in effect. 


When local time is called for, the program consults the system to determine the time zone and 
whether the standard U.S.A. daylight saving time adjustment is appropriate. The program 
knows about the peculiarities of this conversion in 1974 and 1975; if necessary, a table for 
these years can be extended. 


Timezone returns the name of the time zone associated with its first argument, which is meas- 
ured in minutes westward from Greenwich. If the second argument is 0, the standard name its 
used, otherwise the Daylight Saving version. If the required name does not appear in a table 
built into the routine, the difference from GMT is produced; e.g. in Afghanistan timezone(- 
(60°4+ 30), 0) is appropriate because it is 4:30 ahead of GMT and the string GMT +4:30 is 
produced. 
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SEE ALSO 
time (2) 


BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 


isalpha, isupper, islower, isdigit, isalnum, isspace, ispunct, isprint, iscntrl, isascii — character 
classification 


SYNOPSIS 
#include <ctype.h> 


isalpha(c) 


DESCRIPTION 
These macros classify ASCII-coded integer values by table lookup. Each is a predicate return- 
ing nonzero for true, zero for false. J/sascii is defined on all integer values; the rest are defined 
only where isascii is true and on the single non-ASCII value EOF (see stdio(3)). 


isalpha cis a letter 
isupper cis an upper case letter 
islower cis a lower case letter 
isdigit cis a digit 
isalnum cis an alphanumeric character 
isspace c iS a space, tab, carriage return, newline, or formfeed 
ispunct cis a punctuation character (neither control nor alphanumeric) 
isprint cis a printing character, code 040(8) (space) through 0176 (tilde) 
iscntrl cis a delete character (0177) or ordinary control character (less than 040). 
isascii cis an ASCII character, code less than 0200 
SEE ALSO 
ascii(7) 
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curses — screen functions with ‘‘optimal”’ 


g 


cursor motion 


files ~lcurses -- ltermcap [ libraries ] 


These routines give the user a method of updating screens with reasonable optimization. They 
keep an image of the current screen, and the user sets up an image of a new one. Then the 
refresh() tells the routines to make the currevt screen look like the new one. In order to initial- 
ize the routines, the routine initscr() must be called before any of the other routines that deal 


with windows and screens are used. 


SEE ALSO 


The routine endwin() should be called before exiting. 


Screen Updating and Cursor Movement Optimization: A Library Package, Ken Arnold, 


stty (2), env termeap(5) 


AUTHOR 
Ken Aft 


FUNCTIONS 

addch (ch) 

addstr (str) 
box (win, vert, hor) 
ermode() 
clear () 
clearok (scr, boolf) 
cirtobor() 
cirtoeol () 
deichQ 
deleteinQ 
deiwin (win) 
echo() 
endwin() 
erase () 
geich}) 
getcap (name) 
getstr (str) 
gettmode () 
getyx (win,y,x) 
inch Q 
initser Q 
insch(c) 
insertinQ 
leaveok (win, boolf) 
longname (termbuf,name) 
move(y,x) 
mveur (lasty,lastx,newy newx) 
newwin (lines,cols, begin_y,begin_x) 
alQ 
nocrmode () 


old 


noraw () 
overlay (winl,win2) 
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add a character to sidscr 
add a string to sidsc 
draw a box around a window 
set cbrea- mode 

clear stdscr 

set clear flag for ser 

clear to bottom on stdscr 
clear to end of line on ssdser 
delete a character 
delete a line 

delete win 

set echo mode 

end window modes 
erase stdscr 

get a char through stdsc 
get terminal capability name 

get a string through sidscr 

get tty modes 

get (y,x) co-ordinates 

get char at current (y,x) co-ordinates 
initialize screens 

insert a char 

insert a line 

set leave flag for win 

get long name from termbuf 

move to (y,x) on sidsc 
actually move cursor 
create a new window 

set newline mapping 

unset cbreak mode 

unset echo mode 

unset newline mapping 
unset raw mode 

overlay winl on win2 
overwrite winl on top of win 
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printw(fmt,arg! ,arg2,...) printf on stdscr 

raw () set raw mode 

refresh () make current screen look like stdscr 
resetty () reset tty flags to stored value 
savetty () stored current tty flags 

scanw (fmt,arg],arg2,...) scanf through stdscr 

scroll (win) scroll win one line 

scrollok (win, boolf) set scroll flag 

setterm (name) set term variables for name 
standend() end standout mode 

standout () | start standout mode 
subwin(win,lines,cols, begin_y,begin_x) create a subwindow 

touchwin (win) ‘‘change’’ all of win 

unctri (ch) printable version of ch 
waddch (win,ch) add char to win 

waddstr (win, str) add string to win 

welear (win) clear win 

welrtobot (win) clear to bottom of win 
wcirtoeol (win) clear to end of line on win 
wdelch(win,c) delete char from win 
wdeletein (win) delete line from win 

werase (win) erase win 

wegetch (win) get a char through win 
wgetstr(win,str) get a string through win 
winch (win) get char at current (y,x) in win 
winsch (win,c) insert char into win 
winsertin (win) insert line into win 
wmove(win,y,x) set current (y,x) co-ordinates on win 
wprintw(win,fmt arg] ,arg2,...) printf on win 

wrefresh (win) make screen look like win 
wscanw (win,fmt,arg1,arg2,...) scanf through win 
wstandend (win) end standout mode on win 
wstandout (win) start standout mode on win 
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NAME 


dbminit, fetch, store, delete, firstkey, nextkey — data base subroutines 


SYNOPSIS 


typedef struct { 
char edptr; 
int dsize; 

} datum: 

dbminit (file) 

char «file; 


datum fetch (key) 
datum key; 


store(key, content) 
datum key, content; 


delete(key) 
datum key; 


datum firstkey 0 


datum nextkey (key) 
datum key; 


DESCRIPTION 


These functions maintain key/content pairs in a data base. The functions will handle very large 
(a billion blocks) databases and will access a keyed item in one or two file system accesses. The 
functions are obtained with the loader option ~Idbm. 


Keys and contents are described by the datum typedef. A datum specifies a string of dsize bytes 
pointed to by dprr. Arbitrary binary data, as well as normal ASCII strings, are allowed. The data 
base is stored in two files. One file is a directory containing a bit map and has ‘.dir’ as its suffix. 
The second file contains all data and has ‘.pag’ as its suffix. 


Before a database can be accessed, it must be opened by dbminit. At the time of this call, the 
files file.dir and fAle.pag must exist. (An empty database is created by creating zero-length 
‘ dir’ and ‘.pag’ files.) | 

Once open, the data stored under a key is accessed by fetch and data is placed under a key by 
store. A key (and its associated contents) is deleted by delete. A linear pass through all keys in 
a database may be made, in an (apparently) random order, by use of firstkey and nextkey. First- 
key will return the first key in the database. With any key sextkey will return the next Key in 
the database. This code will traverse the data base: 


for (key = firstkeyQ; key.dptr !== NULL; key = nextkey(key)) 


DIAGNOSTICS 


BUGS 


All functions that return an int indicate errors with negative values. A zero return indicates ok. 
Routines that return a datum indicate errors with a null (0) dpzr. 


The ‘.pag’ file will contain holes so that its apparent size is about four times its actual content. 
Older UNIX systems may create real file blocks for these holes when touched. These files can- 
not be copied by normal means (cp, cat, tp, tar, ar) without filling in the holes. 


Dptr pointers returned by these subroutines point into static storage that is changed by subse- 
quent calls. 


The sum of the sizes of a key/content pair must not exceed the internal block size (currently 
1024 bytes). Moreover all key/content pairs that hash together must fit on a single block. 
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Store will return an error in the event that a disk block fills with inseparable data. 
Delete does not physically reclaim file space, although it does make it available for reuse. 


The order of keys presented by firstkey and nextkey depends on a hashing function, not on any- 
thing interesting. 


CoO 
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NAME 
ecvt, fcvt, gevt — output conversion 
SYNOPSIS 
char eecyt(value, ndigit, decpt, sign) 
double value; 
int ndigit, «decpt, «sign; 


char «fevt(value, ndigit, decpt, sign) 
double value; 
int ndigit, edecpt, esign; 


char *gcevt(value, ndigit, buf) 
double value; 
char «buf; — 


DESCRIPTION . 
Ecvt converts the va/ue to a null-terminated string of ndigit ASCII digits and returns a pointer 
thereto. The position of the decimal point relative to the beginning of the string is stored 
indirectly through decpt (negative means to the left of the returned digits). If the sign of the 
result is negative, the word pointed to by sign is non-zero, otherwise it is zero. The low-order 
digit is rounded. 


Fevt is identical to ecvt, except that the correct digit has been rounded for Fortran F-format out- 
put of the number of digits specified by ndigits. 

_ Gevt converts the va/ue to a null-terminated ASCII string in dufand returns a pointer to buf It 
attempts to produce ndigit significant digits in Fortran F format if possible, otherwise E format, 
ready for printing. Trailing zeros may be suppressed. 

SEE ALSO 
printf(3) 


BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 
end, etext, edata — last locations in program 
SYNOPSIS OO 
extern end; 
extern etext; 
extern edata; 
DESCRIPTION 


These names refer neither to routines nor to locations with interesting contents. The address 


of etext is the first address above the program, text, eaalg above the initialized data region, and 
end above the uninitialized data region. 


When execution begins, the program break. ebincides ik end, od it is reset by the routines 


brk(2), malloc(3), standard input/output (srdio(3)), the profile (—p) option of cc(1), etc. The 
current value of the program break is reliably returned by ‘sbrk(0)’, see drk(2). 


SEE ALSO 
brk(2), malloc(3) 
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NAME 
exp, log, logl0, pow, sqrt — exponential, logarithm, power, square root 


SYNOPSIS 
#include <math.h> 


double exp(x) 
double x; 


double log (x) 
double x; 


double logi0(x) 
double x; 


double pow(x, y) 
double x, y; 


double sqrt (x) 
double x; 


DESCRIPTION 
Exp returns the exponential function of x. 


Log returns the natural logarithm of x; /og/0 returns the base 10 logarithm. 
Pow returns x’. 
Sart returns the square root of x. 


SEE ALSO 
hypot(3), sinh(3), intro(2) 


DIAGNOSTICS 
Exp and pow return a huge value when the correct value would overflow, erro is set to 
ERANGE. Pow returns 0 and sets errno to EDOM when the second argument is negative and 
non-integral and when both arguments are 0. 


Log returns 0 when x is zero or negative; errno is set to EDOM. 
Sqrt returns 0 when x is negative; errno is set to EDOM. 
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NAME 
fclose, fflush — close or flush a stream 


SYNOPSIS | 
#include <stdio.h 


felose (stream) 
FILE *stream; 


flush (stream) 
FILE *stream; 
DESCRIPTION 
Fclose causes any buffers for the named stream to be emptied, and the file to be closed. Buffers 
allocated by the standard input/output system are freed. 
Fclose is performed automatically upon calling exit(2). 


Fflush causes any buffered data for the named output sream to be written to that file. The 
stream remains open. 

SEE ALSO 
close(2), fopen(3), setbuf(3) 

DIAGNOSTICS 


These routines return EOF if stream is not associated with an output file, or if buffered data 
cannot be transferred to that file. 
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NAME 
feof, ferror, clearerr, fileno — stream status inquiries 


SYNOPSIS 
#include <stdio.h> 


feof (stream) 
FILE estream; 


ferror (stream) 
FILE «stream 


clearerr (stream) 
FILE *stream 


fileno (stream) 
FILE *stream; 


DESCRIPTION 
Feof returns non-zero when end of file is read on the named input stream, otherwise zero. 


Ferror returns non-zero when an error has occurred reading or writing the named stream, other- 


wise zero. Unless cleared by clearerr, the error indication lasts until the stream is closed. 
Clrerr resets the error indication on the named siream. 
Fileno returns the integer file descriptor associated with the stream, see open(2). 
These functions are implemented as macros; they cannot be redeciared. 
SEE ALSO 
fopen(3), open(2) 
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NAME 


SYNOPSIS _ J bgedie ee 
#include<mathh> 

double floor(x) 
double x; 
double ceil (x) 
double x; 
double fabs (x) 

double x; 


DESCRIPTION 
Fabs returns the absolute value |x|. 


Floor returns the largest integer not greater than x. 
Ceil returns the smallest integer not less than x. 


SEE ALSO 
abs(3) 


fabs, floor, ceil — absolute value, floor, ceiling functions _ 
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NAME 
fopen, freopen, fdopen — open a stream 


SYNOPSIS 
#include <stdio.h> 


FILE «fopen (filename, type) 
char *filename, *type; 


FILE *freopen (filename, type, stream) 
char ¢filename, *type; 
FILE *stream; 


FILE *fdopen(fildes, type) 
char *type; 


DESCRIPTION 
Fopen opens the file named by fename and associates a stream with it. Fopen returns a pointer 
to be used to identify the stream in subsequent operations. 


Type is a character siring having one of the following values: 


Bg 


r” open for reading 


w" create for writing 


SF ng, OF 


a" append: open for writing at end of file, or create for writing 

In addition, each gype may be followed by a °+° to have the file opened for reading and writing. 
"r+" positions the stream at the beginning of the file, “w+” creates or truncates it, and "a+" 
positions it at the end. Both reads and writes may be used on read/write streams, with the limi- 
tation that an /seek, rewind, or reading an end-of-file must be used between a read and a write 
or vice-versa. : 

Freopen substitutes the named file in place of the open szream. It returns the original value of 
stream. The original stream is closed. 


Freopen is typically used to attach the preopened constant names, stdin, stdout, stderr, to 
specified files. 


Fdopen associates a stream with a file descriptor obtained from open, dup, creat, or pipe(2). The 
cype of the stream must agree with the mode of the open file. 


SEE ALSO 

open(2), fclose (3) 
DIAGNOSTICS 

Fopenand freopen return the pointer NULL if Alename cannot be accessed. 
BUGS 

Fdopenis not portable to systems other than UNIX. 


The read/write gpes do not exist on all systems. Those systems without read/write modes will 
probably treat the ope as if the ’+’ was not present. 
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NAME 
fread, fwrite — buffered binary input/output 
SYNOPSIS 
 #include <stdio.h> 


fread(ptr, sizeof (*ptr), nitems, stream) 
FILE *stream; 


fwrite(ptr, sizeof(*ptr), nitems, stream) 
FILE *stream; ; 


DESCRIPTION | 
Fread reads, into a block beginning at prr, nitems of data of the type of «ptr from the named 
input stream. It returns the number of items actually read. 


If stream is stdin and the standard output is line buffered, then any partial output line will be 
flushed before any call to read(2) to satisfy the /read. 


Fwrite appends at most nitems of data of the type of «pir beginning at ptr to the named output 
stream. \t returns the number of items actually written. 
SEE ALSO 
read(2), write(2), fopen(3), getc(3), putc(3), gets(3), puts(3), printf(3), scanf(3) 
DIAGNOSTICS 
Fread and fwrite return 0 upon end of file or error. 


BUGS 
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NAME 
frexp, idexp, modf — split into mantissa and exponent 
SYNOPSIS 
double frexp(value, eptr) 
double value; 
int *eptr; 
double Idexp(value, exp) 
double value; 
double modf(value, iptr) 
double value, *iptr; 
DESCRIPTION 


Frexp returns the mantissa of a double value as a double quantity, x, of magnitude less than 1 
and stores an integer n such that value = x*2" indirectly through eptr. 


Ldexp returns the quantity value+ ar 


Modf returns the positive fractional part of va/ue and stores the integer part indirectly through 
iptr. 


7th Edition 3-22 


FSEEK (3S) UNIX Programmer’s Manual FSEEK (3S) 


NAME 

fseek, ftell, rewind — reposition a stream 
SYNOPSIS 

#include <stdio.h> 


fseek (stream, offset, ptrname) 
FILE *stream; me 
long offset; 


long ftell (stream) 

FILE «stream; 

rewind (stream) 
DESCRIPTION 


Fseek sets the position of the next input or output operation on the stream. The new position is 
at the signed distance offset bytes from the beginning, the current position, or the end of the 
file, according as ptrname has the value 0, 1, or 2. 


Fseek undoes any effects of ungetc(3). 
Ftell returns the current value of the offset relative to the beginning of the file associated with 


the named stream. It is measured in bytes on UNIX; on some other systems it is a magic 
cookie, and the only foolproof way to obtain an offser for fseek. 


Rewind(stream) is equivalent to fseek(stream, OL, 0). 


SEE ALSO 
Iseek (2), fopen(3) 


DIAGNOSTICS 
Fseek returns —1 for improper seeks. 
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NAME 
gamma — log gamma function 
SYNOPSIS 
#include <math.h> 
double gamma (x) 
double x; 
DESCRIPTION 
Gamma returns In | (jx|)|. The sign of F(|x|) is returned in the external integer signgam. 
The following C program might be used to calculate I: 
y ™ gamma(x); 
if (y > 88.0) 
error(); 
y = exp(y); 
if(signgam) 
) Mena oS 
DIAGNOSTICS 
A huge value is returned for negative integer arguments. 
BUGS 
There should be a positive indication of error. 
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NAME ~ =s DER ee MAST ss ae Gof ; Bs Stains 
getarg, iargc — command arguments to Fortran 7 Pe Peele ast 


SYNOPSIS 
subroutine getarg( argno, string ) 
integer argno 
character «(+*) string 
iarge() 
DESCRIPTION 
These procedures permit Fortran programs to access the command arguments. The integer 
function iarge returns the number of command arguments. The subroutine getarg stores the 
nth command argument in its second argument. The string is truncated or padded with blanks, 
in accord with the rules of Fortran character assignment. 
The command 
go arg] argument2 
will return 2 as the value of iarge. If s is declared character*4, then 
call getarg(2, s) 
will put ‘‘argu’”’ in s. 
SEE ALSO 
exec(2) 


3-25 


er ¢ paae oe e 
im PaaS rea ry 


GETC (35S) 


NAME 
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getc, getchar, fgetc, getw — get character or word from stream 


SYNOPSIS 


#include <stdio.h> 


int getc(stream) 
FILE *stream; 


int getchar() 


int fgetc (stream) 
FILE *stream; 


int getw(stream) 
FILE ¢stream; 


DESCRIPTION 


Getc returns the next character from the named input srream. 
Getchar() is identical to getc(stdin). 


Fegetc behaves like gefc, but is a genuine function, not a macro; it may be used to save object 
text. 


Getw returns the next word (32-bit integer on a VAX-11) from the named input szream. It 
returns the constant EOF upon end of file or error, but since that is a good integer value, feof 
and /ferror(3) should be used to check the success of gerw. Getw assumes no special alignment 
in the file. 


SEE ALSO 


fopen(3), pute(3), gets(3), scanf(3), fread(3), ungetc(3) 


DIAGNOSTICS 


BUGS 


These functions return the integer constant EOF at end of file or upon read error. 


A stop with message, ‘Reading bad file’, means an attempt has been made to read from a 
stream that has not been opened for reading by /fopen. 


The end-of-file return from gefchar is incompatible with that in UNIX editions 1-6. 


Because it is implemented as a macro, gefc treats a stream argument with side effects incorrectly. 
In particular, ‘getc(*f-+- +);’ doesn’t work sensibly. 
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NAME 

getenv — value for environment name 
SYNOPSIS 

char *getenv (name) 

char *name; 
DESCRIPTION 


Geteny searches the environment list (see environ(5)) for a string of the form name = value and 
returns value if such a string is present, otherwise 0 (NULL). 


SEE ALSO 
environ(5), exec(2) 
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NAME 

getfsent, getfsspec, getfsfile, setfsent, endfsent — get file system descriptor file entry 
SYNOPSIS 

#include <fstab.h> 

struct fstab *getfsent() 


struct fstab *getfsspec (name) 
char «name; 


struct fstab «getfsfile(name) 

char «name; 

int setfsend() 

int endfsent() 
DESCRIPTION 


Getfsent, getfsspec and getfsfile each return a pointer to an object with the following structure 
containing the broken-out flelds of a line in the file system description file, /usr/include/fsiab.h. 


#define FSINMLG 16 


struct fstab| 
char fs_spec{[FSNMLG], 
char fs_file[ FSNMLG], 
char _fs_type[3]; 
int fs freq; 
int fs_passno; 
}; 
The fields have meanings described in /51a6(5). 
Gerfsent reads the next line of the file, opening the file if necessary. 
Setfsent opens and rewinds the file. 
Endfsent closes the file. 


Getfsspec and get/sfile sequentially search from the beginning of the file until a matching special 
file name or file system file name is found, or until EOF is encountered. 


FILES 
/etc/fstab 
SEE ALSO 
fstab(5) 
DIAGNOSTICS 
Null pointer (0) returned on EOF or error. 
BUGS 
All information is contained in a static area’so it must be copied if it is to be saved. 
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NAME 


getgrent, getgrgid, getgrnam, setgrent, endgrent — get group file entry 


SYNOPSIS 


#include <grp.h> 

struct group *getgrent() 

struct group *getergid (gid) 

int gid; | 
struct group *getgrnam (name) 
char «name; 

setgrent() 

endgrent () 


DESCRIPTION 


Getgrent, getgrgid and getgrnam each return pointers to an object with the following structure 
containing the broken-out fields of a line in the group file. 


struct group { /* see getgrent(3) «/ 
char gr name; 
char *gr_passwd; 
int gr_gid; 
char gr mem; 
hs 
The members of this structure are: 


gr name The name of the group. 

gr_passwd The encrypted password of the group. 

gr_gid The numerical group-ID. 

gr_mem Null-terminated vector of pointers to the individual member names. 


Getgrent simply reads the next line while gergrgid and gelgrnam search until a matching gid or 
name is found (or until EOF is encountered). Each routine picks up where the others leave off 
so successive calls may be used to search the entire file. 


A call to sergrent has the effect of rewinding the group file to allow repeated searches. Endgrent 
may be called to close the group file when processing is complete. 


/etc/group 


é a ho wer 
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getlogini3), getpwentioj, group\>) 


DIAGNOSTICS 


BUGS 


Doar hes 


A null pointer (0) is returned on EOF or error. 


All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 


getlogin — get login name 
SYNOPSIS 

char *getloginQ 
DESCRIPTION 


Getlogin retumms a pointer to the login name as found in /etc/utmp. It may be used in conjunc- 
tion with getpwnam to locate the correct password file entry when the same userid is shared by 
several login names. 
If getlogin is called within a process that is not attached to a typewriter, it returns NULL. The 
correct procedure for determining the login name is to first call getlogin and if it fails, to call 
getpwuid. 

FILES 
/etc/utmp 


SEE ALSO 
getpwent(3), getgrent(3), utmp(S) 


DIAGNOSTICS 
Returns NULL (0) if name not found. 


BUGS 
The return values point to static data whose content is overwritten by each call. 
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NAME 
getpass — read a password 
SYNOPSIS 
char «getpass (prompt) 
char «prompt; 
DESCRIPTION 
Getpass reads a password from the file /dev/tty, or if that cannot be opened, from the standard 
input, after prompting with the null-terminated string prompt and disabling echoing. A pointer 
is returned to a null-terminated string of at most 8 characters. 
FILES 
/dev/tty 
SEE ALSO 
erypt(3) 
BUGS 
The return value points to static data whose content is overwritten by each call. 
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NAME 
getpw — get name from uid 
SYNOPSIS 
getpw (uid, buf). 
char ebuf; 
DESCRIPTION 
Getpw searches the password file for the (numerical) uid, and fills in buf with the corresponding 
line; it returns non-zero if uid could not be found. The line is null-terminated. 


FILES 
/etc/passwd 
SEE ALSO 
getpwent(3), passwd(5) 


DIAGNOSTICS 
Non-zero returm on error. 
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NAME 


getpwent, getpwuid, getpwnam, setpwent, endpwent — get password file entry 


SYNOPSIS 


#include <pwd.h> | 
struct passwd *getpwent() 

struct passwd *getpwuid (uid) 
int uid; 

struct passwd *getpwnam (name) 
char «name; 

int setpwent() 


int endpwentQ 


DESCRIPTION 


Getpwent, getpwuid and getpwnam each return a pointer to an object with the following structure 
containing the broken-out fields of a line in the password file. 


struct passwd { /* see getpwent(3) «/ 
char *pw_name; 
char  »*pw_passwd; 


int pw_uid; 
int pw_gid; 
int pw_quota; 


char *pw_comment; 
char *pw_gecos; 
char *pw_dir; 
char »pw_shell; 
i 
The fields pw_quota and pw_comment are unused; the others have meanings described in 
passwd(5). 


Getpwent reads the next line (opening the file if necessary); setpwent rewinds the file; endpwent 
closes it. 


Getpwuid and getpwnam search from the beginning until a matching wid or name is found (or 
until EOF is encountered). 


/etc/passwd 


SEE ALSO 


getlogin(3), getgrent(3), passwd(5) 


DIAGNOSTICS 


Null pointer (0) returned on EOF or error. 


All information is contained in a static area so it must be copied if it is to be saved. 
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NAME 
gets, fgets — get a string from a stream 


SYNOPSIS 
#include <stdio.h> 


char *gets(s) 
char ¢s; 
char «fgets(s, n, stream) 
char ss; 
FILE *stream; 
DESCRIPTION 
Gets reads a String into s from the standard input stream stdin. The string is terminated by a 
newline character, which is replaced in s by a null character. Gers returns its argument. 


Frets reads n—1 characters, or up to a newline character, whichever comes first, from the 
stream into the string s. The last character read into s is followed by a null character. Fgets 
returns its first argument. 


SEE ALSO 
puts(3), getc(3), scanf(3), fread(3), ferror(3) 


DIAGNOSTICS 

Gets and fgets return the constant pointer NULL upon end of file or error. 
BUGS 

Gets deletes a newline, fgets keeps it, all in the name of backward compatibility. 
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NAME 

hypot, cabs — Euclidean distance 
SYNOPSIS 

#include <math.h> 

double hypot(x, y) 

double x, y; 

double cabs (z) 

struct { double x, y;} z: 
DESCRIPTION 

Hypot and cabs return 

sart(x*x + yy), 
taking precautions against unwarranted overflows. 


SEE ALSO 
exp(3) for sqrt 
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NAME 

jO, jl, jn, yO, yl, yn — bessel functions 
SYNOPSIS 

#include <math.h> 


double j0(x) 
double x; 


double j1 (x) 
double x; 
double jn(n, x) 
double x; 
double y0(x) 
double x; 


double y1(x) 
double x; 


double yn(n, x) 
double x; 


DESCRIPTION 
These functions calculate Bessel functions of the first and second kinds for real arguments and 
integer orders. 

DIAGNOSTICS 


Negative arguments cause y0, y/, and yn to return a huge negative value and set errno to 
EDOM. 
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NAME 
jobs — summary of job control facilities 


SYNOPSIS 
#include <sys/ioct].h> 
#include <signal.h> 
#include <sys/vtimes.h > 
#include <wait.h> 


int fildes, signo; 
short pid, perp; 
union wait status; 
struct vtimes vt; 


ioct! (fildes, TIOCSPGRP, &pegrp) 
ioctl (fildes, TIOCGPGRP, &pgrp) 


setpgrp(pid, perp) 
getperp (pid) 

killpg (perp, signo) 
sigset(signo, action) 
sighold (signo) 
sigrelse(signo) 
sigpause(signo) 
sigsys(signo, action) 


wait3(&status, options, &vt) 
ce... ~Iljobs 


DESCRIPTION 
The facilities described here are used to support the job control implemented in csh(1), and 
may be used in other programs to provide similar facilities. Because these facilities are not 
standard in UNIX and because the signal mechanisms are also slightly different, the associated 
routines are not in the standard C library, but rather in the —Ijobs library. 


For descriptions of the individual routines see the various sections listed in SEE ALSO below. 
This section attempt only to place these facilities in context, not to explain the semantics of the 
individual calls. 


Terminal arbitration mechanisms. 


The job centro! mecharism works fw assomiating with zach process a number called a process 
group ; related processes f2.g. in # nineline? are iver ine ss:se process group. The system 
assigns a single process group numbe: 10 each icriuisiai. Frocesses running on a terminal are 


given read access to that terminal only if they are in the same process group as that terminal. 


Thus a command interpreter may start several jobs running in different process groups and arbi- 
trate access to the terminal by controlling which, if any, of these processes is in the same pro- 
cess group as the terminal. When a process which is not in the process group of the terminal 
tries to read from the terminal, all members of the process group of the process receive a 
SIGTTIN signal, which normally then causes them to stop until they are continued with a 
SIGCONT signal. (See sigsys(2) for a description of these signals; sty(4) for a description of 


process groups.) 


If a process which is not in the process group of the terminal attempts to change the terminals 
mode, the process group of that process is sent a SIGTTOU signal, causing the process group to 
stop. A similar mechanism is (optionally) available for output, causing processes to block with 
SIGTTOU when they attempt to write to the terminal while not in its process group; this ts 
controlled by the LTOSTOP bit in the tty mode word, enabled by “‘stty tostop’’ and disabled 
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(the default) by “‘stty —tostop.’” (The LTOSTOP bit is described in tty(4)). 
How the shell manipulates process groups. 


A shell which is interactive first establishes its own process group and a process group for the 
terminal; this prevents other processes from being inadvertantly stopped while the terminal is 
under its control. The shell then assigns each job it creates a distinct process group. When a 
job is to be mun in the foreground, the shell gives the terminal to the process group of the job 
using the TIOCSPGRP ioctl (See jocrl(2) and tty(4)). When a job stops or completes, the shell 
reclaims the terminal by resetting the terminals process group to that of the shell using 
TIOCSPGRP again. 


Shells which are running shell scripts or running non-interactively do not manipulate process 
groups of jobs they create. Instead, they leave the process group of sub-processes and the ter- 
minal unchanged. This assures that if any sub-process they create blocks for terminal i/o, the 
shell and all its sub-processes will be blocked (since they are a single process group). The first 
interactive parent of the non-interactive shell can then be used to deal with the stoppage. 


Processes which are orphans (whose parents have exited), and descendants of these processes 
are protected by the system from stopping, since there can be no interactive parent. Rather 
than blocking, reads from the control terminal return end-of-file and writes to the control ter- 
minal are permitted (i.e. LTOSTOP has no effect for these processes.) Similarly processes 
which ignore or hold the SIGTTIN or SIGTTOU signal are not sent these signals when access- 
ing their control terminal; if they are not in the process group of the control terminal reads 
simply return end-of-file. Output and mode setting are also allowed. 


Before a shell suspends itself, it places itself back in the process group in which it was created, 
and then sends this original group a stopping signal, stopping the shell and any other intermedi- 
ate processes back to an interactive parent. The shell also restores the process group of the ter- 
minal when it finishes, as the process which then resumes would not necessarily be in control 
of the terminal otherwise. 


Naive processes. 


A process which does not alter the state of the terminal, and which does no job control can 
invoke subprocesses normally without worry. If such a process issues a system(3) call and this 
command is then stopped, both of the processes will stop together. Thus simple processes need 
not worry about job control, even if they have “‘shell escapes’’ or invoke other processes. 


Processes which modify the terminal state. 


When first setting the terminal into an unusual mode, the process should check, with the stop- 
ping signals held, that it is in the foreground. It should then change the state of the terminal, 
and set the catches for SIGTTIN, SIGTTOU and SIGTSTP. The following is a sample of the 
code that will be needed, assuming that unit 2 is known to be a terminal. 


short tpgrp;- 


retry: . a 
sigset (SIGTSTP, SIG_HOLD); 
sigset(SIGTTIN, SIG_HOLD); 
sigset(SIGTTOU, SIG_HOLD);. 
if (iocth(2, TIOCGPGRP, &tpgrp) '= 0) 
goto nottty; 
if (tparp != getpgrp(0)) { /* not in foreground */ 
sigset(SIGTTOU, SIG_DFL); 
kill(0, SIGTTOU); 
/* job stops here waiting for SIGCONT #/ 
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goto retry; 


...save old terminal modes and set new modes... 
sigset (SIGTTIN, onstop); 
sigset (SIGTTOU, onstop); 

- sigset(SIGTSTP, onstop); 


It is necessary to ignore SIGTSTP in this code because otherwise our process could be moved 
from the foreground to the background in the middle of checking if it is in the foreground. 
The process holds all the stopping signals in this critical section so no other process tn our pro- 
cess group can mess us up by blocking us on one of these signals in the middle of our check. 
(This code assumes that the command interpreter will not move a process from foreground to 
background without stopping it; if it did we would have no way of making the check correctly.) 


The routine which handles the signal should clear the catch for the stop signal and kill(2) the 
processes in its process group with the same signal. The statement after this ki// will be exe- 
cuted when the process is later continued with SIGCONT. 


Thus the code for the catch routine might look like: 


sigset (SIGTSTP, onstop); 
sigset(SIGTTIN, onstop); 
sigset(SIGTTOU, onstop); 


onstop(signo) 
int signo; 


.. restore old terminal state ... 
sigset(signo, SIG_DFL); 

kill(O, signo); 

/* stop here until continued «/ 
sigset (signo, onstop); 

.. restore our special terminal state ... 


} 


This routine can also be used to simulate a stop signal. 


If a process does not need to save and restore state when it is stopped, but wishes to be notified 
when it is continued after a stop it can catch the SIGCONT signal; the SIGCONT handler will 
be run when the process is continued. 


Processes which lock data bases such as the password file should ignore SIGTTIN, SIGTTOU, 
and SIGTSTP signals while the data bases are being manipulated. While a process is ignoring 
SIGTTIN signals, reads which would normally have hung will return end-of-file, writes which 
would normally have caused SIGTTOU signals are instead permitted while SIGTTOU is 
ignored. 

Interrupt-level process handling. 


Using the mechanisms of sigser(3) it is possible to handle process state changes as they occur 
by providing an interrupt-handling routine for the SIGCHLD signal which occurs whenever the 
status of a child process changes. A signal handler for this signal is established by: 


sigset (SIGCHLD, onchild); 
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The shell or other process would then await a change in child status with code of the form: 


recheck: 
sighold(SIGCHLD); /* start critical section */ 
if (no children to process) { 
sigpause(SIGCHLD); /* release SIGCHLD and pause #/ 
goto recheck; 


sigrelse(SIGCHLD); /* end critical region «/ 
/* now have a child to process #/ 


Here we are using sighold to temporarily block the SIGCHLD signal during the checking of the 
data structures telling us whether we have a child to process. If we didn’t block the signal we 
would have a race condition since the signal might corrupt our decision by arriving shortly after 
we had finished checking the condition but before we paused. 


If we need to wait for something to happen, we call signause which automically releases the hold 
on the SIGCHLD signal and waits for a signal to occur by starting a pawse(2). Otherwise we 
simply release the SIGCHLD signal and process the child. Sigpause is similar to the PDP-11 
wait instruction, which returns the priority of the processor to the base level and idles waiting 
for an interrupt. 


It is important to note that the long-standing bug in the signal mechanism which would have 
lost a SIGCHLD signal which occurred while the signal was blocked has been fixed. This is 
because sighold uses the SIG_HOLD signal set of sigsys(2) to prevent the signal action from 
being taken without losing the signal if it occurs. Similarly, a signal action set with sigser has 
the signal held while the action routine is running, much as a the interrupt priority of the pro- 
cessor is raised when a device interrupt is taken. 


In this interrupt driven style of termination processing it is necessary that the wa/st calls used to 
retrieve status in the SIGCHLD signal handler not block. This is because a single invocation of 
the SIGCHLD handler may indicate an arbitrary number of process status changes: signals are 
not queued. This is similar to the case in a disk driver where severai drives on a single con- 
troller may report status at once, while there is only one interrupt taken. It is even possible for 
no children to be ready to report status when the SIGCHLD handler is invoked, if the signal 
was posted while the SIGCHLD handler was active, and the child was noticed due to a 
SIGCHLD initially sent for another process. This causes no problem, since the handler will be 
called whenever there is work to do; the handler just has to collect all information by calling 
waits until it says no more information is available. Further status changes are guaranteed to 
be reflected in another SIGCHLD handler cail. 


Restarting system calls. 


In older versions of UNIX ‘‘slow’’ system calls were interrupted when signals occurred, return- 
ing EINTR. The new signal mechanism sigser(3) normally restarts such calls rather than inter- 
rupting them. To summarize: pause and wait return error EINTR (as before), ioctl and wait? 
restart, and read and write restart unless some data was read or written in which case they 
return indicating how much data was read or written. In programs which use the older sig- 
nal(2) mechanisms, all of these calls return EINTR if a signal occurs during the call. 


SEE ALSO 

csh(1), ioctl(2), killpg(2), setpgrp(2), sigsys(2), wait3(2), signal(3), tty (4) 
BUGS 
7 The job control facilities are not available in standard version 7 UNIX. These facilities are still 
under development and may change in future releases of the system as better inter-process 
communication facilities and support for virtual terminals become available. The options and 
specifications of these system calls and even the calls themselves are thus subject to change. 
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NAME 
I3tol, ltol3 — convert between 3-byte integers and long integers 
SYNOPSIS 
I3tol (Ip, cp, n) 
long *lp; 
char cp; 
Itol3 (cp, Ip, n) 
char cp; 
long «lp; 
DESCRIPTION 
Li3tol converts a list of n three-byte integers packed into a character string pointed to by cp into 
a list of long integers pointed to by Ip. 
Ltol3 performs the reverse conversion from long integers (/p) to ‘adams integers ( cp). 


These functions are useful for file-system maintenance where the i-numbers are three bytes 
long. 

SEE ALSO 
filsys (5) 
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NAME 


malloc, free, realloc, calloc —- main memory allocator 


SYNOPSIS 


char smalloc(size) 
unsigned size; 


free (ptr) 


char *ptr; 

char *realloc(ptr, size) 
char «ptr; 

unsigned size; 

char *calloc(nelem, elsize) 
unsigned nelem, elsize; 


DESCRIPTION 


Malloc and free provide a simple general-purpose memory allocation package. Malloc returns a 
pointer to a block of at least size bytes beginning on a word boundary. 


The argument to free is a pointer to a block previously allocated by malloc, this space is made 
available for further allocation, but its contents are left undisturbed. 


Needless to say, grave disorder will result if the space assigned by malloc is overrun or if some 
random number is handed to /ree. 


Malloc allocates the first big enough contiguous reach of free space found in a circular search 
from the last block allocated or freed, coalescing adjacent free blocks as it searches. It calls sdrk 
(see break(2)) to get more memory from the system when there is no suitable space already 
free. 


Realloc changes the size of the block pointed to by prr to size bytes and returns a pointer to the 


(possibly moved) block. The contents will be unchanged up to the lesser of the new and oid 
sizes. 


Realloc also works if ptr points to a block freed since the last call of malloc, realloc or calloc. 
thus sequences of /ree, malloc and realloc can exploit the search strategy of maiioc to do storage 
compaction. 


Calloc allocates space for an array of nelem elements of size elsize. The space is initialized to 
zeros. 


Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer 
coercion) for storage of any type of object. 


DIAGNOSTICS 


BUGS 


Mailoc, realloc and calloc return a nuil pointer (0) if there is no available memory or if the 
arena has been detectably corrupted by storing outside the bounds of a block. Malloc may be 
recompiled to check the arena very stringently on every transaction; see the sources code. 


When reailloc returns 0, the block pointed to by pfr may be destroyed. 


The current incarnation of the allocator is unsuitable for direct use in a large virtual environ- 
ment where many small blocks are to be kept, since it keeps all allocated and freed blocks on a 
single circular list. Just before more memory is allocated, all allocated and freed blocks are 


referenced; this can cause a huge number of page faults. 
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NAME 
mktemp — make a unique file name 
SYNOPSIS 
char «mktemp(template) 
char *template; 
DESCRIPTION : 
Mktemp replaces template by a unique file name, and returns the address of the template. The 
template should look like a file name with six trailing X’s, which will be replaced with the 
current process id and a unique letter. 
SEE ALSO 
getpid(2) 
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NAME 


SYNOPSIS 


monitor - prepare executicn profile 


monitor (low pe, highpc, buffer, bufsize, nfunc) 
int (elowpe) 0, (shighpe) 0; 
short buffer{]; 


DESCRIPTION 


FILES 


An executable programm created by ‘cc —p’ automatically includes calls for monitor with default 
parameters; monitor needn't be called explicitly except to gain fine control over profiling. 


Monitor is an interface to profil(2). Lowpc and highpc are the addresses of two functions, buffer 


is the address of a (user supplied) array of dbu/fSize short integers. Monitor arranges to record a 


histogram of periodically sampled values of the program counter, and of counts of calls of cer- 
tain functions, in the buffer. The lowest address sampled is that of /owpe and the highest is just 
below Aighpc. At most nfunc call counts can be kept; only calls of functions compiled with the 
profiling option —p of cc(1) are recorded. For the results to be significant, especially where 
there are small, heavily used routines, it is suggested that the buffer be no more than a few 
times smaller than the range of locations sampled. 


To profile the entire program, it is sufficient to use 
extern etext(); 


monitor((int) 2, etext, buf, bufsize, nfunc); 

Evext lies just above all the program text, see end(3). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor(0); 

then prof(1) can be used to examine the results. 


mon.out 


SEE ALSO 


prof(1), profil(2), ce(1) 
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NAME 
nlist — get entries from name list 


SYNOPSIS 
#include <nlist.h> 
nlist (filename, nl) 
char «filename; 
struct nlist nlf]; 


DESCRIPTION | | 
Nlist examines the name list in the given executable output file and selectively extracts a list of 
values. The name list consists of an array of structures containing names, types and values. 
The list is terminated with a null name. Each name is looked up in the name list of the file. If 
the name is found, the type and value of the name are inserted in the next two fields. If the 
name is not found, both entries are set to 0. See a.our(5) for the structure declaration. 


This subroutine is useful for examining the system name list kept in the file /ymunix. In this 
way programs can obtain system addresses that are up to date. : 


SEE ALSO 
a.out(5) 


DIAGNOSTICS 
All type entries are set to 0 if the file cannot be found or if it is not a valid namelist. 
BUGS . 
On other versions of UNIX you must include <a.out.h> rather than <nlist.h>; this is unfor- 


tunate, but <a.out.h> can’t be used on the VAX because it contains a union which can’t be 
initialized. ; 
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NAME 
perror, sysS_errlist, sys_nerr — system error messages 


SYNOPSIS 
perror (s) 
char *S; 


int sys_nerr; 
char *sys_errlist[]; 


DESCRIPTION | 
Perror produces a short error message on the standard error file describing the last error 
encountered during a call to the system from a C program. First the argument string s is 
printed, then a colon, then the message and a new-line. Most usefully, the argument string is 
the name of the program which incurred the error. The error number is taken from the exter- 
nal variable errno (see intro(2)), which is set when errors occur but not cleared when non- 
erroneous calls are made. 


To simplify variant formatting of messages, the vector of message strings sys _errlist is provided; 
errno can be used as an index in this table to get the message string without the newline. 
Sys_nerr is the number of messages provided for in the table; it should be checked because new 
error codes may be added to the system before they are added to the table. 


SEE ALSO 
intro(2) 
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NAME 

plot: openpl et al. — graphics interface 
SYNOPSIS 

openplQ) 

erase () 


label (s) 
char s{l]; 


line(x1, yl, x2, y2) 

circle(x, y, r) 

arce(x, y, x0, y0, x1, yl) 

move(x, y) 

cont(x, y) 

point (x, y) 

linemod (s) 

char sl]; 

space(x0, y0, x1, yl) 

closep! 0) 
DESCRIPTION 


These subroutines generate graphic output in a relatively device-independent manner. See 
plot(S) for a description of their effect. Openp/ must be used before any of the others to open 
the device for writing. Closepl/ flushes the output. 


String arguments to /abel and linemod are null-terminated, and do not contain newlines. 


Various flavors of these functions exist for different output devices. They are obtained by the 
following /d(1) options: 


—Iplot device-independent graphics stream on standard output for p/or(1) filters 
—1300 GSI 300 terminal 

—1300s GSI 300S terminal 

~-1450 DASI 450 terminal 

14014 Tektronix 4014 terminal 


SEE ALSO 
plot(5), plot(1), graph(1) 
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NAME 


popen, pclose — initiate I/O to/from a process 


SYNOPSIS 


#include <stdio.h> 


FILE *popen(command, type) 
char «command, «type; 


pclose (stream) 
FILE *stream; 


DESCRIPTION 


The arguments to popen are pointers to nuil-terminated strings containing respectively a shell 
command line and an [/O mode, either "r" for reading or "w" for writing. It creates a pipe 
between the calling process and the command to be executed. The value returned is a stream 
pointer that can be used (as appropriate) to write to the standard input of the command or read 
from its standard output. 


A stream opened by popen should be closed by pclose, which waits for the associated process to 
terminate and returns the exit status of the command. 


Because open files are shared, a type "r" command may be used as an input filter, and a type 
“w" as an output filter. 


SEE ALSO 


pipe(2), fopen(3), fclose(3), systerm(3), wait(2) 


DIAGNOSTICS 


BUGS 


Popen returns a null pointer if files or processes cannot be created, or the Shell cannat be 
accessed. 


Pclose returns —1 if stream is not associated with a ‘popened’ command. 


Buffered reading before Opening an input filter may leave the standard input of that filter 
mispositioned. Similar problems with an output filter may be forestalled by careful buffer flush- 
ing, e.g. with Mush, see fclose(3). 
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printf, fprintf, sprintf — formatted output conversion 
SYNOPSIS . 
#include < stdio.h> 


printf(format [, arg]... ) 
char ¢format; 


fprintf(stream, format [, arg]... ) 
FILE *stream; 
char format; 


sprintf(s, format [, arg]... ) 
char *s, format; 


DESCRIPTION 


Printf places output on the standard Suto Stream stdout. Fprintf places output on the named 
output stream. Sprintfplaces ‘output’ in the string s, followed by the character ‘\0’. 


Each of these functions converts, formats, and prints its arguments after the first under control 
of the first argument. The first argument is a character string which contains two types of 
objects: plain characters, which are simply copied to the output stream, and conversion 
specifications, each of which causes conversion and printing of the next successive arg printf. 


Each conversion specification is introduced by the character %. Following the %, there may be 


= an optional minus sign ‘— ” which specifies left adjustment of the converted value in the 
indicated field; - 


- an optional digit string specifying a ffeld width; if the converted value has fewer charac- 
ters than the field width it will be blank-padded on the left (or right, if the left- 
adjustment indicator has been given) to make up the field width; if the field width 
begins with a zero, zero-padding will be done instead of blank-padding; 


_ an optional period ‘*.’ which serves to separate the field width from the next digit string; 


an optional digit string specifying a precision which specifies the number of digits to 
appear after the decimal point, for e- and f-conversion, or the maximum number of 
characters to be printed from a string, 


= the character | specifying that a following d, o, x, or u corresponds to a long integer 
arg. (A capitalized conversion code accomplishes the same thing.) 
oe a character which indicates the type of conversion to be applied. 


A field width or precision may be ‘e’ instead of a digit string. In this case an integer arg sup- 
plies the field width or precision. 


The conversion characters and their meanings are | 
dox The integer argis converted to. decimal, écial: or hexadecimal notation respectively. 


f The float or double arg is. converted to decimal notation in the style ‘{ —]ddd.ddd’ 
where the number of d’s after the decimal point is equal to the precision specification 
for the argument. If the precision is missing, 6 digits are given; if the precision is 
explicitly 0, no digits and. no decimal point are printed. 

@ The float or double arg is converted in the style ‘[—]d.ddde-+tdd’ where there is one 


digit before the decimal point and the number after is equal to the precision 
specification for the argument; when the precision is missing, 6 digits are produced. 


g The float or double argis printed in ie be in style f, or in style e, whichever gives full 
precision in minimum space. 
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¢ The character argis printed. 


$ Arg is taken to be a string (character pointer) and characters from the string are printed 
until a null character or until the number of characters indicated by the precision 
specification is reached, however if the precision is 0 or missing all characters up to a 
null are printed. 


u The unsigned integer arg is converted to decimal and printed (the result will be in the 
range 0 through MAXUINT, where MAXUINT equals 4294967295 on a VAX-11 and 
65536 on a PDP-11). 


% Print a ‘%’; no argument is converted. 


In no case does a non-existent or small field width cause truncation of a field; padding takes 
place only if the specified field width exceeds the actual width. Characters generated by printf 
are printed by purc(3). 


Examples 
To print a date and time in the form ‘Sunday, July 3, 10:02°, where weekday and month are 
pointers to null-terminated strings: 


printf ("%s, %s %d, %02d:%02d", weekday, month, day, hour, min); 
To print w to 5 decimals: 
printf ("pi = %.5f, 4eatan(1.0)). 


SEE ALSO 
putc(3), scanf(3), ecvt(3) 


BUGS 
Very wide fields (>128 characters) fail. 
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NAME 


putc, putchar, fputc, putw — put character or word on a stream 


SYNOPSIS 


#include <stdio.h> 


int putc(c, stream) 
char c; 
FILE *stream; 


putchar(c) 


fputc(c, stream) 
FILE *stream; 


putw(w, stream) 
FILE *stream; 


DESCRIPTION 


Putc appends the character cto the named output stream. It returns the character written. 
Putchar(c) is defined as putc(c, stdout). | 


Fputc behaves like putc, but is a genuine function rather than a macro. It may be used to save 
on object text. 


Putw appends word (i.e. int) wto the output stream. It returns the word written. Pu/w neither 
assumes nor causes special alignment in the file. 


The standard stream stdout is normally buffered if and only if the output does not refer to a ter- 
minal; this default may be changed by setbuf(3). The standard stream stderr is by default 
unbuffered unconditionally, but use of freopen (see fopen(3)) will cause it to become buffered; 
setbuf, again, will set the state to whatever is desired. When an output stream is unbuffered 
information appears on the destination file or terminal as soon as written; when it is buffered 
many characters are saved up and written as a block. Fflush (see fclose(3)) may be used to 
force the block out early. 


SEE ALSO 


fopen(3), fclose(3), getc(3), puts(3), printf(3), fread(3) 


DIAGNOSTICS 


BUGS 


These functions return the constant EOF upon error. Since this is a good integer, ferror(3) 
should be used to detect purw errors. 


Because it is implemented as a macro, putc treats a stream argument with side effects improp- 
erly. In particular ‘putc(c, *f++);’ doesn’t work sensibly. 


Errors can occur long after the call to purc. 
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NAME 
puts, fputs — put a string on a stream 


SYNOPSIS 
#include <stdio.h> 


puts(s) 

char *s; 

fputs(s, stream) — 
char ¢s; 

FILE *stream; 


DESCRIPTION 
Puts copies the null-terminated string s to the standard output stream stdout and appends a new- 
line character. 


Fputs copies the null-terminated string s to the named output stream. 
Neither routine copies the terminal null character. 


SEE ALSO 
fopen(3), gets(3), putc(3), printf(3), ferror(3) 
fread(3) for fwrite 
BUGS 
Puts appends a newline, /puts does not, all in the name of backward compatibility. 
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NAME 
qsort — quicker sort 


SYNOPSIS 
qsort (base, nel, width, compar) 
char «base; 
int (ecompar)(); 


DESCRIPTION 
Qsort is an implementation of the quicker-sort algorithm. The first argument is a pointer to the 
base of the data; the second is the number of elements; the third is the width of an element in 
bytes; the last is the name of the comparison routine to be called with two arguments which are 
pointers to the elements being compared. The routine must return an integer less than, equal 
to, or greater than O according as the first argument is to be considered less than, equal to, or 
greater than the second. 


SEE ALSO 
sort(1) 
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NAME 
rand, srand — random number generator 


SYNOPSIS 
srand (seed) 
int seed; 


rand() 


DESCRIPTION 
Rand uses a multiplicative congruential random number generator with period 2°* to return suc- 
cessive pseudo-random numbers in the range from 0 to 2?! —1. 


The generator is reinitialized by calling srand with | as argument. It can be set to a random 
Starting point by calling srand with whatever you like as argument. 
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NAME 
re_comp, re_exec — regular expression handler 


SYNOPSIS 
char *re_comp(s) 
char *s; 
re_exec(s) 
char *s; 
DESCRIPTION 


Re_comp compiles a string into an internal form suitable for pattern matching. Re_exec checks 
the argument string against the last string passed to re_comp. 


Re_comp returns 0 if the string s was compiled successfully; otherwise a string containing an er- 
ror message is returned. If re_comp is passed 0 or a null string, it returns without changing the 
currently compiled regular expression. 


Re_exec returns 1 if the string s matches the last compiled regular expression, 0 if the string s 
failed to match the last compiled regular expression, and -1 if the compiled regular expression 
was invalid (indicating an internal error). 


The strings passed to both re_comp and re_exec may have trailing or embedded newline charac- 
ters; they are terminated by nulls. The regular expressions recognized are described in the 
manual entry for ed (1), given the above difference. 

SEE ALSO 
ed(1), ex(1) 


DIAGNOSTICS 
Re_exec returns -1 for-an internal error. 


Re_comp returns one of the following strings if an error occurs: "No previous regular expres- 
sion”, "Regular expression too long”, "unmatched \(", “missing ]", "too many \(\) pairs”, “un- 
matched \)”. 
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NAME 
scanf, fscanf, sscanf — formatted input conversion 
SYNOPSIS 
#include <stdio.h> 
- scanf(format [, pointer]... ) 


char *format; 


fscanf(stream, format [ , pointer]... ) 
FILE *stream; 
char «format; 


sscanf(s, format [, pointer]... ) 
char *s, «format; 


DESCRIPTION 
Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. 
Sscanf reads from the character string s. Each function reads characters, interprets them 
according to a format, and stores the results in its arguments. Each expects as arguments a 
control string format, described below, and a set of pointer arguments indicating where the con- 
verted input should be stored. 


ecifications, which are used to direct interpre- 


The control string usually contains conversion 5] 
tation of input sequences. The control string may contain: 


1. Blanks, tabs or newlines, which match optionai white space in the input. 
2. Anordinary character (not %) which must match the next character of the input stream. 


3. Conversion specifications, consisting of the character %, an optional assignment suppress- 
ing character *, an optional numerical maximum fleld width, and a conversion character. 


A conversion specification directs the conversion of the next input field; the result is placed in 
the variable pointed to by the corresponding argument, unless assignment suppression was indi- 
cated by ». An input field is defined as a string of non-space characters; it extends to the next 
inappropriate character or until the field width, if specified, is exhausted. 


The conversion character indicates the interpretation of the input field; the corresponding 
pointer argument must usually be of a restricted type. The following conversion characters are 
legal: 


% a single ‘%’ is expected in the input at this point; no assignment is done. 
d a decimai integer is expected; the corresponding argument should be an integer pointer. 
® an octal integer is expected; the corresponding argument should be a integer pointer. 


x a hexadecimal integer is expected; the corresponding argument should be an integer 
pointer. 


s a character string is expected; the corresponding argument should be a character pointer 
pointing to an array of characters large enough to accept the string and a terminating ‘\0’, 
which will be added. The input field is terminated by a space character or a newline. 


¢ a character is expected; the corresponding argument should be a character pointer. The 
normal skip over space characters is suppressed in this case, to read the next non-space 
character, try “%ls’. If a field width is given, the corresponding argument should refer to a 
character array, and the indicated number of characters is read. 


a floating point number is expected; the next field is converted accordingly and stored 
through the corresponding argument, which should be a pointer to a float. The input for- 
mat for floating point numbers ts an optionally signed string of digits possibly containing a 
decimal point, followed by an optional exponent field consisting of an E or e followed by 


ome DP 
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an optionally signed integer. 


{ indicates a string not to be delimited by space characters. The left bracket is followed by a 
set of characters and a right bracket; the characters between the brackets define a set of 
characters making up the string. If the first character is not circumflex (*), the input field 
is all characters until the first character not in the set between the brackets; if the first char- 
acter after the left bracket is ~, the input field is all characters until the first character which 


is in the remaining set of characters between the brackets. The polsespoueiae argument 
must point to a character array. 


The conversion characters d, o and x may be capitalized or preceeded by | to indicate that a 
pointer to long rather than to int is in the argument list. Similarly, the conversion characters e 
or f may be capitalized or preceded by 1 to indicate a pointer to double rather than to float. The 


conversion characters d, o and x may be preceeded by h to indicate a pointer to short rather 
than to int. 


The scanf functions return the number of successfully matched and assigned input items. This 
can be used to decide how many input items were found. The constant EOF ts returned upon 
end of input; note that this is different from 0, which means that no conversion was done; if 
conversion was intended, it was frustrated by an inappropriate character in the input. 


For example, the call 


int i; float x; char name[50]: 
scanf("%d%f%s", &i, &x, name): 
with the input line 
25 54.32E-—1 thompson 


will assign to ithe value 25, x the value 5.432, and name will contain ‘thompson\0’. Or, 
int i: float x; char name[50}; 
scanf ("%2d%f%«*d%(1234567890]", &i, &x, name); 
with input 
56789 0123 56a72 
will assign 56 to i, 789.0 to x, skip ‘0123’, and place the string *56\0’ in name. The next call to 
getchar will return ‘a’ 
SEE ALSO | 
atof(3), getc(3), printf(3) 


DIAGNOSTICS | 
The scanf functions return EOF on end of input, and a short count for missing or illegal data 
items. 

BUGS 
The success of literal matches and suppressed assignments is not directly determinable. 
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NAME 
setbuf — assign buffering to a stream 


SYNOPSIS 


#Hinclude <stdio.h> 


setbuf(stream, buf) 
FILE *stream; 
char ebuf; 


DESCRIPTION 


Serbuf is used after a stream has been opened but before it is read or written. It causes the 
character array dbufto be used instead of an automatically allocated buffer. If dufis the constant 
pointer NULL, input/output will be completely unbuffered. 


A manifest constant BUFSIZ tells how big an array is needed: 
char buf{BUFSIZ]-. 


A buffer is normally obtained from mialloc(3) upon the first gefc or putc(3) on the file, except 
that the standard output is line buffered when directed to a terminal. Other output streams 
directed to terminals, and the standard error stream siderr are normally not buffered. If the 
standard output is line buffered, then it is flushed each time data is read from the standard 
input by reed(2). 


SEE ALSO 


BUGS 


fopen(3), getc(3), putc(3), malloc(3) 


The standard error strearn should be line buffered by default. 
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NAME 
setymp, longjmp — non-local goto 
SYNOPSIS 
#include <setjmp.h> 
setjmp(eny) 


jmp_buf env; 
longjmp(eny, val) 
jmp_buf envy; 
DESCRIPTION 
These routines are useful for dealing with errors and interrupts encountered in a low-level sub- 
routine of a program. 
Setjmp saves its stack environment in env for later use by /ongjmp. It returns value 0. 


Longjmp restores the environment saved by the last call of setjmp. It then returns in such a way 
that execution continues as if the call of setjmp had just returned the value va/ to the function 
that invoked setjmp, which must not itself have returned in the interim. All accessible data 
have values as of the time /ongjmp was called. 


SEE ALSO 
signal (2) 
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NAME 

sigset, signal, sighold, sigignore, sigrelse, sigpause — manage signals 
SYNOPSIS 


#include <signal.h> 
void action(); 

int Sig; 

sigset (sig, action) 
signal (sig, action) 


sighold (sig) 
sigignore (sig) 
sigrelse (sig) 


sigpause (sig) 
cc... ~Iljobs 


DESCRIPTION 
This is a package of signal management functions to manage the signals as described in sig- 
sys(2). These functions are available only in this version of UNIX, and should not be used 
when the mechanisms of signa/(2) would suffice, as they would then impair portability. These 
functions are contained in the jods library, obtained by specifying the loader option —ljobs. 


Sigset is used to provide a default signal handler for signal sig. This function is remembered 
across subsequent calls to the other functions, and need not be specified again. After sigser 
instances of sig will cause an interrupt to be taken at func, with the signal then heid so that 
recursive trapping due to the signal will not occur. During normal return from func, the rou- 
tines arrange for the signal action to be restored so that subsequent signals will also trap to func. 
if a non-local exit is to be taken, then sigre/se must be called to un-hold the signal action, res- 
toring the original catch. Func may also be specified as SIG_DFL, SIG_IGN or SIG_HOLD, as 
described in sigsys(2). The value specified on the previous call to sigsefis returned; if sigser has 
never been called, then the default action inherited from the system is returned. 


Signal is like sigset, but the signal will not be held when the action routine ts called; rather it 
will have reverted to SIG_DFL. This is generally unsafe, but is included for backwards compa- 
tibility to the old signal mechanism. It should not be used. 


Sighold and sigrelse may be used to block off sig in a piece of code where it cannot be tolerated. 
After sigrefse the catch initially set with sigser will be restored. 


Sigignore can be used to temporarily set the action for sig to ignore the signal. If the signal had 
been held before the call to sigignore, any pending instance of the signal will be discarded. 


Sigpause may be used by a routine which wishes to check for some condition produced at inter- 
rupt level by the sig signal, and then to pause waiting for the condition to arise with the catch 

of the signal enabled. In correct usage it must be preceded by an instance of sighold to block 
the signal. Sigpause is like pause in that it will return after anv signal is processed. The usual 
thing to do then is to reenable the hold with sighold, check the condition again, and sigpause 
again if the condition has not arisen. 


SEE ALSO 
sigsys(2), signal(2), jobs(3), tty (4) 
BUGS 
Sighold and sigrelse do not nest; the first sigrefse restores the default catch. 


These functions store information in data space. You thus must call sigsys(2) rather than any 
of sigset or signal after a vfork(2) in the child which is to then exec(2). 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 — trigonometric functions 

SYNOPSIS | 
#include <math.h> 


double sin(x) 
double x; 


double cos(x) 
double x; 


double asin (x) 
double x; 


double acos (x) 
double x; 


double atan(x) 
double x; 


double atan2(x, y) 
double x, y; 
DESCRIPTION 


Sin, cos and tan return trigonometric functions of radian arguments. The magnitude of the 
argument should be checked by the caller to make sure the result is meaningful. 


Asin returns the arc sin in the range —7/2 to 7/2. 

Acos returns the arc cosine in the range 0 to 7. 

Atan returns the arc tangent of x in the range —-7r/2 to 7/2. 
Atan2 returns the arc tangent of x/y in the range —7r to 7. 


- DIAGNOSTICS 
Arguments of magnitude greater than 1 cause asin and acos to retum value 0; errno is set to 
EDOM. The value of tan at its singular points is a huge number, and errno is set to ERANGE. 


BUGS 
The value of tan for arguments greater than about 2**31 is garbage. 
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NAME 
sinh, cosh, tanh — hyperbolic functions 


SYNOPSIS 
#include <math.h> 


double sinh(x) 


double cosh (x) 
double x; 


double tanh(x) 
double x; 


DESCRIPTION 
These functions compute the designated hyperbolic functions for real arguments. 


DIAGNOSTICS 
Sink and cosh return a huge value of appropriate sign when the correct value would overflow. 
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NAME 
sleep — suspend execution for interval 


SYNOPSIS 
sleep (seconds) 
unsigned seconds; 


DESCRIPTION 
The current process is suspended from execution for the number of seconds specified by the 
argument. The actual suspension time may be up to | second less than that requested, because 


scheduled wakeups occur at fixed l-second intervals, and an arbitrary amount longer because of 
other activity in the system. 


The routine is implemented by setting an alarm clock signal and pausing until it occurs. The 
previous State of this signal is saved and restored. If the sleep time exceeds the time to the 


alarm signal, the process sleeps only until the signal would have occurred, and the signal is sent 
1 second later. 


SEE ALSO 
alarm(2), pause(2) 
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NAME 
stdio — standard buffered input/output package 


SYNOPSIS 
#include <stdio.h> 


FILE «stdin; 
FILE «stdout; 
FILE «stderr; 


DESCRIPTION 
The functions described in Sections 3S constitute an efficient user-level buffering scheme. The 
in-line macros getc and putc(3) handle characters quickly. The higher level routines gers, /gers, 
scanf, fscanf, fread, puts, fputs, printf, forintf, fwrite all use gefc and putc; they can be freely inter- 
mixed. 


A file with associated buffering is called a stream, and is declared to be a pointer to a defined 
type FILE. Fopen(3) creates certain descriptive data for a stream and returns a pointer to desig- 
nate the stream in all further transactions. There are three normally open streams with con- 
Stant pointers declared in the include file and associated with the standard open files: 


stdin standard input file 
stdout standard output file 
stderr standard error file 


A constant ‘pointer’ NULL (0) designates no stream at all. 


An integer constant EOF (—1) is returned upon end of file or error by integer functions that 
deal with streams. 


Any routine that uses the standard input/output package must include the header file 
<stdio.h> of pertinent macro definitions. The functions and constants mentioned:in sections 
labeled 3S are declared in the include file and need no further declaration. The constants, and 
the following ‘functions’ are implemented as macros; redeciaration of these names is perilous: 
getc, getchar, putc, putchar, feof, ferror, fileno. 


SEE ALSO. 
open(2), close(2), read(2), write(2) 


DIAGNOSTICS 
| The value EOF is returned uniformly to indicate that a FILE pointer has not been initialized 
with fopen, input (output) has been attempted on an output (input) stream, or a FILE pointer 
designates corrupt or otherwise unintelligible FILE data. 


For purposes of efficiency, this implementation of the standard library has been changed to line 
buffer output to a terminal by default and attempts to do this transparently by flushing the out- 
put whenever a read(2) from the standard input is necessary. This is almost always tran- 
sparent, but may cause confusion or malfunctioning of programs which use standard i/o rou- 
tines but use read(2) themselves to read from the standard input. 


In cases where a large amount of computation is done after printing part of a line on an output 
terminal, it is necessary to flush(3) the standard output before going off and computing so that 
the output will appear. 
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NAME 


Strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, index, rindex — string operations 


SYNOPSIS 


char *strcat(s1, s2) 
char «sl, «s2; 


char *strncat(sl1, s2, n) 
char *sl, «s2; 
stremp(sl, s2) 

char *sl, *s2; 
strnemp(sl, s2, n) 
char «sl, °s2; 

char *strepy (sl, s2) 
char «sl, *s2; 

char *strnepy(sl, s2, n) 
char es1, *s2; 

strien (s) 

char °*s; 

char *index(s, c) 

char *s, c; 


char *rindex(s, c) 
char *s, ¢c; 


DESCRIPTION 


BUGS 


These functions operate on null-terminated strings. They do not check for overflow of any 
receiving string. 


Strcat appends a copy of string s2 to the end of string sJ. Strncat copies at most nm characters. 
Both return a pointer to the null-terminated result. 


Sircmp compares its arguments and returns an integer greater than, equal to, or less than 0, 
according as si is lexicographically greater than, equal to, or less than s2. Strncmp makes the 
same comparison but looks at at most »n characters. 


Strcpy copies string s2 to s/, stopping after the null character has been moved. Sérncpy copies 
exactly characters, truncating or null-padding s2,; the target may not be null-terminated if the 
length of s2is nor more. Both return s/. 


Strlen returns the number of non-null characters in s. 


Index (rindex) returns a pointer to the first (last) occurrence of character c in string s, or zero if 
c does not occur in_ the string. 


Strcmp uses native character comparison, which is signed on PDP11’s and VAX-11’s, unsigned 
on other machines. 
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NAME 
swab — swap bytes 


SYNOPSIS 
swab(from, to, nbytes) 
char «from, *to; 


DESCRIPTION 


SWAB (3) 


Swab copies nbytes bytes pointed to by /rom to the position pointed to by to, exchanging adja- 
cent even and odd bytes. It is useful for carrying binary data between PDP11’s and other 


machines. Nbytes should be even. 
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NAME 
system — issue a shell command 
SYNOPSIS 
system (string) 
char *string; 
DESCRIPTION 
System causes the string to be given to sh(1) as input as if the string had been typed as a com- 


mand at a terminal. The current process waits until the shell has completed, then returns the 
exit status of the shell. : 


SEE ALSO 
popen(3), exec(2), wait(2) 


DIAGNOSTICS 
Exit status 127 indicates the shell couldn’t be executed. 
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NAME 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs — terminal independent operation routines 


SYNOPSIS 


char PC; 
char *BC; 
char «UP; 
short ospeed; 


tgetent(bp, name) 
char «bp, «name; 


tgetnum (id) 
char *id; 


tgetflag (id) 
char sid; 


char * 
tgetstr(id, area) 
char *id, «*area; 


char ® 
tgoto(cm, destcol, destline) 
char *cm; 


tputs(cp, affent, oute) 
register char *cp; 

int affcnt; 

int (*outce) Q; 


DESCRIPTION 


These functions extract and use capabilities from the terminal capability data base rermcap(5). 
These are low level routines; see curses(3) for a higher level package. 


Tgetent extracts the entry for terminal name into the buffer at bp. Bp should be a character 
buffer of size 1024 and must be retained through all subsequent calls to teernum, tgetflag, and 
igetstr. Tgetent returns —1 if it cannot open the termcap file, 0 if the terminal name given does 
not have an entry, and 1] if ail goes well. It will look in the environment for a TERMCAP vari- 
able. If found, and the value does not begin with a slash, and the terminal type name is the 
same as the environment string TERM, the TERMCAP string is used instead of reading the 
termcap file. If it does begin with a slash, the string is used as a path name rather than 
/etciltermcap. This can speed up entry into programs that call tgetent, as well as to help debug 
new terminal descriptions or to make one for your terminal if you can’t write the file 
letc/termcap. 


Tgetnum gets the numeric value of capability id, returning —1 if is not given for the terminal. 
Tgetfiag returns 1 if the specified capability is present in the terminal’s entry, 0 if it is not. 
Tgetstr gets the string value of capability id, placing it in the buffer at area, advancing the area 
pointer. It decodes the abbreviations for this field described in termcap(S), except for cursor 
addressing and padding information. 


Tgoto returns a cursor addressing string decoded from cm to go to column destco/ in line destline. 
It uses the external variables UP (from the up capability) and BC (if be is given rather than bs) 
if necessary to avoid placing \n, “D or *@ in the returned string. (Programs which call tgoto 
should be sure to turn off the XTABS bit(s), since tgoto may now output a tab. Note that pro- 
grams using termcap should in general turn off XTABS anyway since some terminals use con- 
trol I for other functions, such as nondestructive space.) If a % sequence is given which is not 
understood, then ‘goto returns ‘““OOPS’’. | 
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Tputs decodes the leading padding information of the string cp; affent gives the number of lines 
affected by the operation, or 1 if this is not applicable, ouwtc is a routine which is called with 
each character in turn. The external variable ospeed should contain the output speed of the ter- 
minal as encoded by srty (2). The external variable PC should contain a pad character to be 
used (from the pe capability) if a null (“@) is inappropriate. 


FILES 
/usr/lib/libtermcap.a —Iltermcap library 
/etc/termcap data base 
SEE ALSO 
ex(1), curses(3), termcap(5) 
AUTHOR 
William Joy 
BUGS 
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NAME 
ttyname, isatty, ttyslot — find name of a terminal 


SYNOPSIS 
char *ttyname(fildes) 


isatty (fildes) 
ttyslot 0 


DESCRIPTION 
Ttyname retums a pointer to the null-terminated path name of the terminal device associated | 


with file descriptor fildes. 
[satty returns 1 if fildes is associated with a terminal device, 0 otherwise. 


Ttyslot returns the number of the entry in the ¢tys(5) file for the control terminal of the current 
process. 
FILES 


/dev/# 
/etc/ttys 


SEE ALSO 
ioctl(2), ttys(5) 


DIAGNOSTICS 
Ttyname returns a null pointer (0) if jfiildes does not describe a terminal device in directory 


‘/dev’. 
Ttysiot returns 0 if ‘/etc/ttys’ is inaccessible or if it cannot determine the control terminal. 


BUGS 
The return value points to static data whose content is overwritten by each call. 
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NAME 
ungetc — push character back into input stream 


SYNOPSIS 
#include <stdio.h> 


ungete(c, stream) 
FILE *stream; 


DESCRIPTION 
Ungetc pushes the character c back on an input stream. That character will be returned t by the 
next gefc call on that stream. Ungetc returns c. 


One character of pushback is guaranteed provided something has been read from the stream 
and the stream is actually buffered. Attempts to push EOF are rejected. 


Fseek(3) erases all memory of pushed back characters. 


SEE ALSO 
getc(3), setbuf(3), fseek(3) 


DIAGNOSTICS 
Ungetc returns EOF if it can’t push a character back. 
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NAME 
valloc — aligned memory allocator 


SYNOPSIS 
char evalloc(size) 
unsigned size; 

DESCRIPTION 
Valloc allocates size bytes aligned on a boundary adequate for vread(2)). It is implemented by 
calling malloc(3) with a slightly larger request, saving the true beginning of the block allocated, 
and returning a properly aligned pointer. 

DIAGNOSTICS 


Valloc returns a null pointer (0) if there is no available memory or if the arena has been detect- 
ably corrupted by storing outside the bounds of a block. 


BUGS 
Vfree isn’t implemented. 
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NAME 


varargs — variable argument list © 


SYNOPSIS 


#include <varargs.h> 


function(va_alist) 


va_del 

va_list pvar, 
va_start(pvar); 

f = va_arg(pvar, type); 
va_end(pvar); 


DESCRIPTION 


This set of macros allows portable procedures that accept variable argument lists to be written. 
Routines which have variable argument lists (such as printf(3)) that do not use varargs are 
inherently nonportable, since different machines use different argument passing conventions. 


va_alist is used in a function header to declare a variable argument list. 
va_del is a declaration for va_alist. Note that there is no semicolon after va_decl. 


va_list is a type which can be used for the variable pvar, which is used to traverse the list. One 
such variable must always be declared. 


va_start (pvar) is called to initialize pvar to the beginning of the list. 


va_arg (pvar, type) will return the next argument in the list pointed to by pvar. Type is the type 
the argument is expected to be. Different types can be mixed, but it is up to the routine to 
know what type of argument is expected, since it cannot be determined at runtime. 


va_end (pvar) is used to finish up. 
Multiple traversals, each bracketted by va_start .. va_end, are possible. 


EXAMPLE 


BUGS 


#include <varargs.h> 
execl(va_alist) 
va_dcl 
va_list ap; 
char file; 
char «args{100]; 
int argno = Q; 


va_Start(ap); 
file = va _arg(ap, char *); 
while hacysiargnost +] = va _arg(ap, char *)) 


va_end(ap); 
return execv (file, args); 


It is up to the calling routine to determine ow many arguments there are, since it is not possi- 
ble to determine this from the stack frame. For example, exec/ passes a 0 to signal the end of 
the list. Printfcan tell how many arguments are there by the format. 
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NAME 
intro — introduction to special files 
DESCRIPTION 


This section describes the special files and related driver functions available on the system. In 
this section the SYNOPSIS section gives a sample specification of the related drivers for use in 
a system description to the config(8) program. The DIAGNOSTICS section lists messages 
which may appear on the console and in the system error log /usr/adm/messages due to errors 
in device operation. 

SEE ALSO 
config (8) 


: 
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NAME 
autoconf — diagnostics from autoconfiguration code 


DESCRIPTION 
When UNIX bootstraps it probes the innards of the machine it is running on and locates con- 
trollers, drives, and other devices, printing out what it finds on the console. This procedure is 
driven by a system configuration table which is processed by config(8) and compiled into each 
kernel. 


Devices in NEXUS slots are normally noted, thus memory controllers, UNIBUS and MASSBUS 
adaptors. Devices which are not supported which are found in NEXUS slots are noted also. 


MASSBUS devices are located by a very deterministic procedure since MASSBUS space is com- 
pletely probable very easily. If devices exist which are not configured they will be silently 
ignored; if devices exist of unsupported type they will be noted. 


UNIBUS devices are located by probing to see if their control-status registers respond. If not, 
they are silently ignored. If the control status register responds but the device cannot be made 
to interrupt, a diagnostic warning will be printed on the console and the device will not be 
available to the system. (A command attach(8) is planned to cause the device to be attached 
irregardless of its failure to interrupt, after the system is bootstrapped, for irksome devices. 
This is not in as of this writing, however.) 

A generic system may be built which picks its root device at boot time as the ‘‘best’’ available 
device (MASSBUS disks are better than SMD UNIBUS disks are better than RKO07’s; the dev- 
ice must be drive 0 to be considered.) If such a system is booted with the RB_ASKNAME 
option of (see reboor(2V)), then the name of the root device is read from the console terminal 
at boot time, and any available device may be used. 


SEE ALSO 
config (8) | bach 


DIAGNOSTICS 
cpu type %d not configured. You tried to boot UNIX on a cpu type which it doesn’t (or at least 
this compiled version of UNIX doesn’t) understand. 


mba%d at tr%d. A MASSBUS adapter was found in tr%d (the NEXUS slot number). UNIX 
will call it mba%d. 
%d mba’s not configured More MASSBUS adapters were found on the machine than were 
declared in the machine configuration; the excess MASSBUS adapters will not be accessible. 
uba%d at trd. A UNIBUS adapter was found in tr%d (the NEXUS slot number). UNIX will 
call it uba%d. 
dr32 unsupported (at tr %d). A DR32 interface was found in a NEXUS, for which UNIX does 
not have a driver. . 
mer%d at tr%d. A memory controller was found in tr%d (the NEXUS slot number). UNIX 
will call it mcr%d. 
> mcr’s unsupported. UNIX supports only 4 memory controllers per cpu. 
| mpm unsupported (at tr¥%d). Muiti-port memory is unsupported in the sense that UNIX does 
not know how to poll it for ECC errors. 


%s%d at mba%d drive %d. A tape formatter or a disk was found on the MASSBUS; for disks 
%s%d will look like ‘“‘hp0’’, for tape formatters like ‘“‘htl’’ or ‘‘mtl’’. The drive number comes 
from the unit plug on the drive or in the TM formatter (not on the tape drive; see below). 


%s%d at %s%d slave %d. (For MASSBUS devices). Which would look like ‘‘tu0 at ht0 slave 
0’’ or “‘muO at mt0O slave 0°’, where tu@ or mu@ is the name for the tape device and ht0 or mt0 
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is the name for the formatter. A tape slave was found on the tape formatter at the indicated 
drive number (on the front of the tape drive). UNIX will call the device, e.g., tu0 or mu. 


%Ss%d at uba%d csr %o vec %o ipl %x. The device %s%d, e.g. dz0 was found on uba%d at 
control-status register address %o and with device vector %o. The device interrupted at priority 
level %x. 


%s%d at uba%d csr %o zero vector. The device did not present a valid interrupt vector, rather 
presented 0 (a passive release condition) to the adapter. 


%s%d at uba%d csr %o didn’t interrupt. The device did not interrupt, likely because it is bro- 
ken, hung, or not the kind of device it is advertised to be. 


%s%d at %s%d slave %d (For UNIBUS devices). Which would look like ‘‘up0 at scO slave 
0’’, where up0 is the name of a disk drive and sc0 is the name of the controller. Analogous to 
MASSBUS case. 


BUGS 
Should write attach(8) and system call it needs to work. 
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NAME 
bk — line discipline for machine-machine communication 


SYNOPSIS 
pseudo-device bk 


DESCRIPTION 

This line discipline provides a replacement for the old and new tty drivers described in rty(4) 
when high speed output to and especially input from another machine is to be transmitted over 
a asynchronous communications line. The discipline was designed for use by the Berkeley net- 
work nef(1). It may be suitable for uploading of data from microprocessors into the system. If 
you are going to send data over asynchronous communications lines at high speed into the sys- 
tem, you must use this discipline, as the system otherwise may detect high input data rates on 
terminal lines and disables the lines; in any case the processing of such data when normal ter- 
minal mechanisms are involved saturates the system. 


The line discipline is enabled by a sequence: 


#include < sgtty.h> 
int Idisc = NETLDISC, fildes; ... 
ioctl (fildes, TIOCSETD, &ldisc); 


A typical application program then reads a sequence of lines from the terminal port, checking 
header and sequencing information on each line and acknowledging receipt of each line to the 
sender, who then transmits another line of data. Typically several hundred bytes of data and a 
smaller amount of control information will be received on each handshake. 
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The old standard teletype discipline can be restored by doing: 


Idise = OTTYDISC; 
ioctl (fildes, TIOCSETD, &ldisc); 


While in networked mode, normal teletype output functions take place. Thus, if an 8 bit out- 
put data path is desired, it is necessary to prepare the output line by putting it into RAW mode 
using jocti(2). This must be done before changing the discipline with TIOCSETD, as most 
ioctl(2) calls are disabled while in network line-discipline mode. 


When in network mode, input processing is very limited to reduce overhead. Currently the 
input path is only 7 bits wide, with newline the only recognized character, terminating an input 
record. Each input record must be read and acknowledged before the next input is read as the 
system refuses to accept any new data when there is a record in the buffer. The buffer is lim- 
ited in length, but the system guarantees to always be willing to accept input resulting in 512 
data characters and then the terminating newline. 


User level programs should provide sequencing and checksums on the information to guarantee 
accurate data transfer. 


SEE ALSO 
tty (4) 


DIAGNOSTICS 
None. 

BUGS 
The Purdue uploading line discipline, which provides 8 bits and uses timeout’s to terminate 
uploading should be incorporated into the standard system, as it is much more suitable for 
microprocessor connections. 


. Inclusion of this line discipline causes the system to use the input silos on dz’s and dh’s. This 
causes problems with some terminals, which require “S/°Q handshaking to operate but have 
inadequate buffering to tolerate even a small number of characters transmitted after they send a 
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“S. In particular this problem existed on early VT100’s (where, however, an ECO exists to fix 
this problem.) 
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NAME 
cons ~ VAX-11 console interface 


DESCRIPTION 
The console is available to the processor through the console registers. It acts like a normal 
terminal, except that when the local functions are not disabled, control-P puts the console in lo- 
cal console mode (where the prompt is ‘*‘>>>’’). The operation of the console in this mode 
varies slightly per-processor. 


On an 11/780 you can return to the conversational mode using the command ‘‘se t p”’ if the 
processor is still running or ‘‘continue’”’ if it is halted. The latter command may be abbreviated 
‘“*c’’. If you hit the break key on the console, then the console will go into ODT (console de- 
bugger mode). Hit a ‘‘P’’ (upper-case letter p) to get out of this mode. 

On an 11/750 the processor is halted whenever the console is not in conversational mode, and 
typing ‘‘C’’ returns to conversational mode. When in console mode on an 11/750 which has a 
remote diagnosis module, a “D will put you in remote diagnosis mode, where the prompt will 


be ‘“‘“RDM>’’. The command ‘‘ret”’ will return from remote diagnosis mode to local console 
mode. 


With the above proviso’s the console works like any other UNIX terminal. 


FILES 
/dev/console 
SEE ALSO 
tty (4), reboot (3) 
VAX Hardware Handbook 


DIAGNOSTICS 
None. 
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NAME 
ct — phototypesetter interface 
SYNOPSIS 
device ct0 at ubaQ csr 0167760 vector ctintr 
DESCRIPTION 
This provides the interfact to a Graphic Systems C/A/T phototypesetter. Bytes written on the 
file specify font, size, and other control information as well as the characters to be flashed. The 
coding will not be described here. 
Only one process may have this file open at a time. It is write-only. 
FILES 
/dev/cat 
SEE ALSO 
troff(1) 
Phototypesetter interface specification 


DIAGNOSTICS 
None. 
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dh, dm — DH-11/DM-11 communications multiplexer 


SYNOPSIS 


device dhO at uba0 csr 0160020 vector dhrint dhxint 
device dm0 at uba0 csr 0170500 vector dmintr 


DESCRIPTION 


FILES 


A dh-11 provides 16 communication lines; dm-11’s may be optionally paired with dh-11’s to 
provide modem control for the lines. 


Each line attached to the DH-11 communications multiplexer behaves as described in ¢ty(4). 
Input and output for each line may independently be set to run at any of 16 speeds; see ¢ty(4) 
for the encoding. 


Bit iof flags may be specified for a dh to say that a line is not properly connected, and that the 
line should be treated as hard-wired with carrier always present. Thus specifying ‘‘flags 
0x0004’’ in the specification of dhO would cause line ttyh2 to be treated in this way. 


If the Berknet line driver 5k(4) is included in the system, then the dh driver will use its input 
silos and poll for input at each clock tick (normally 1/50’th or 1/60’th of a second) rather than 
taking an interrupt on each input character. 


/dev/tty [hi] [0-9a-f] 
/dev/ttyd[0-9a-f] 


SEE ALSO 


tty (4) 


DIAGNOSTICS 


dh%d: NXM. No response from UNIBUS on a dma transfer within a timeout period. This is 
often followed by a UNIBUS adapter error. This occurs most frequently when the UNIBUS is 
heavily loaded and when devices which hog the bus (such as rk07’s) are present. It is not seri- 
ous. 


dh%d: silo overflow. The 64 character input silo overflowed before it could be serviced. This 
can happen if a hard error occurs when the CPU is running with elevated priority, as the system 
will then print a message on the console with interrupts disabled. If the Berknet ner(1) is run- 
ning on a dhline at high speed (e.g. 9600 baud), there is only 1/15th of a second of buffering 
capacity in the silo, and overrun is possible. This may cause a few input characters to be lost to 
users and a network packet is likely to be corrupted, but the network will recover. It is not 
serious. 
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dn — dn-11 automatic calling unit interface 


SYNOPSIS 


device dnO at uba0 csr 0175200 vector dnintr 


DESCRIPTION 


FILES 


A dn-11 is a controller for an automatic calling unit (ACU). With a dn-11, a call unit, and a 
modem a computer may dial a telephone number and establish a data link. Hardware support- 
ing this interface includes the DEC DN11 and Able Quadracall controllers working with either 
Bell 801 or Racal/Vadic 801 or 811 call units. 


A dn-11 interface can control as many as four call units. In normal operation a data link is 
established by opening the file associated with a call unit, sending the desired phone number in 
a single write(2) operation, then opening the terminal line attached to the appropriate outgoing 
modem. If the phone call was successful and the remote host presented a carrier signal, the 
open on the terminal line should be successful. At this point the call unit should be closed and 
a link has been established. This sequence is normally performed for the user by one of cu(1), 
uucp(1), or dnd(8). 


Each controller/call unit pair has different programming characteristics which impact the pro- 
grammer; the dn-11 interface presents a raw interface rather than imbed local dependencies in 
the device driver. For example, the Racal/Vadic 811 call unit is multiplexed, providing the 
user with the ability to place phones calls on as many as 64 separate phone lines from a single 
interface. This multiplexing is carried out based on the first two digits of the phone number 
presented by the user (the first digit selects the modem’s rack and modem type, while the 
second digit selects the specific modem in the rack). 


The legal dn-11 dial codes are: 0-9, * (: is a synonym), # (; is a synonym), = (w is a 
synonym), and —. A phone number may optionally be terminated with a < or e Phone 
numbers may be no more than 40 characters long. 


By convention /dev/culal]O are connected to a 300 baud interface, while /dev/culal]1 provides 
a 1200 baud interface. 


/dev/cua{0-9] ACU interfaces 
/dev/cul[0-9] associated outgoing terminal line 


SEE ALSO 


rv (4) 
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NAME 
drum — paging device 
DESCRIPTION 
This file refers to the paging device in use by the system. This may actually be a subdevice of 


one of the disk drivers, but in a system with paging interleaved across multiple disk drives it 
provides an indirect driver for the multiple drives. 


FILES 
- /dev/drum 

BUGS 
Reads from the drum are not allowed across the interleaving boundaries. Since these only 
occur every .SMbytes or so, and since the system never allocates blocks across the boundary, 
this is usually not a problem. 
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dz — DZ-11 communications multiplexer 


SYNOPSIS 


device dz0 at ubaO csr 0160100 vector dzrint dzxint 


DESCRIPTION 


FILES 


A dz-11 provides 8 communication lines with partial modem control, adequate for UNIX dialup 
use. Each line attached to the DZ-11 communications multiplexer behaves as described in 
tty(4) and may be set to run at any of 16 speeds; see sry(4) for the encoding. 


Bit iof flags may be specified for a dz to say that a line is not properly connected, and that the 
line should be treated as hard-wired with carrier always present. Thus specifying ‘‘flags 0x04” 
in the specification of dz0 would cause line tty02 to be treated in this way. 


The dz driver normally uses its input silos and polls for input at each clock tick (1/60°th of a 
second) rather than taking an interrupt on each input character. 


/dev/tty [0-9] [0-9] 
/dev/ttyd [0-9a-f] dialups 


SEE ALSO . 


tty (4) 


DIAGNOSTICS 


dz%d: silo overflow. The 64 character input silo overflowed before it could be serviced. This 
can happen if a hard error occurs when the CPU is running with elevated priority, as the system 
will then print a message on the console with interrupts disabled. If the Berknet ner(]) is run- 
ning on a dzline at high speed (e.g. 9600 baud), there is only 1/15th of a second of buffering 
capacity in the silo, and overrun is possible. This may cause a few input characters to be lost to 
users and a network packet is likely to be corrupted, but the network will recover. It is not 
serious. 
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NAME 
fl — floppy interface 


DESCRIPTION 
This is a simple interface to the D.E.C. RX01 floppy disk unit, which is part of the console 
LSI-11 subsytem for VAX-11/780's. Access is given to the entire floppy consisting of 77 tracks 
of 26 sectors of 128 bytes. 
All i/o is raw; the seek addresses in raw transfers should be a multiple of 128 bytes and a mul- 
tiple of 128 bytes should be transferred, as in other ‘‘raw’’ disk interfaces. 

FILES 
/dev/ floppy 


SEE ALSO 
arff (8) 


DIAGNOSTICS 
None. 


BUGS | 
Multiple console floppies are not supported. 


if a write is given with a count not a multiple of 128 bytes then the trailing portion of the last 
sector will be zeroed. 
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NAME 
hk — RK6-11/RK06 and RKO7 moving head disk 
SYNOPSIS 
controller hkO at uba? csr 0177440 vector rkintr 
disk rkQ at hkO drive 0 
disk rk1 at hkO drive 1 
DESCRIPTION 


Files with minor device numbers 0 through 7 refer to various portions of drive 0; minor dev- 
ices 8 through 15 refer to drive 1, etc. The standard device names begin with ‘‘hk’’ followed 
by the drive number and then a letter a-h for partitions 0-7 respectively. The character ? stands 
here for a drive number in the range 0-7. | 

The origin and size of the pseudo-disks on each drive are as follows: 


RKO7 partitions: 


disk Start length cyl 
hk?a 0 15884 0-240 
hk?b 15906 10032 241-392 
hk ?c 0 53790 0-814 
hk 7g 26004 27786 393-813 
RK06 partitions 

disk Start length cyl 

hk ?a 0 15884 0-240 
hk ?b 15906 11154 241-409 
hk ?c 0 27126 0-410 


On a dual RK-07 system partition hk?a is used for the root for one drive and partition hk?g for 
the /usr file system. If large jobs are to be run using hk?b on both drives as swap area provides 
a 1OMbyte paging area. Otherwise partition hk?c on the other drive is used as a single large file 
system. 


The block files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is.also a ‘raw’ interface which pro- 
vides for direct transmission between the disk and the user’s read or write buffer. A single read 
or write call results in exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the raw files conventionally begin 
with an extra ‘r.’ 


In raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise seek calls should 
specify a multiple of 512 bytes. 


FILES 


/dev/hk {0-7} [a-h} block files 
/dev/rhk [0-7] [a-h] raw files 
SEE ALSO 
hp(4), up(4) 
DIAGNOSTICS 


rk%d%ec: hard error sn%d cs2=%b ds=%b er=%b. An unrecoverable error occured during 
transfer of the specified sector of the specified disk partition. The contents of the cs2, ds and 
er registers are printed in octal and symbolically with bits decoded. The error was either unre- 
coverable, or a large number of retry attempts (including offset positioning and drive recalibra- 
tion) could not recover the error. 
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rk%d: write locked The write protect switch was set on the drive when a write was attempted. 
The write operation is not recoverable. 


rk%d: not ready. The drive was spun down or off line when it was accessed. The i/o operation 
is not recoverable. 


rk%d: not ready (came back!). The drive was not ready, but after printing the message about 
being not ready (which takes a fraction of a second) was ready. The operation is recovered if 


no further errors occur. 


rk%d%ec: soft ecc sn%d A recoverable ECC error occurred on the specified sector of the 
specified disk partition. This happens normally a few times a week. If it happens more fre- 
quently than this the sectors where the errors are occuring should be checked to see if certain 
cylinders on the pack, spots on the carriage of the drive or heads are indicated. 


hk%d: lost interrupt A timer watching the controller detected no interrupt for an extended 
period while an operation was outstanding. This indicates a hardware or software failure. 
There is currently a hardware/software problem with spinning down drives while they are being 
accessed which causes this error to occur. The error causes a UNIBUS reset, and retry of the 
pending operations. If the controller continues to lose interrupts, this error will recur a few 
seconds later. 


BUGS 
In raw I/O readand write(2) truncate file offsets to $12-byte block boundaries, and write scrib- 
bles on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, 
read, write and lseek(2) should always deal in 512-byte multiples. 


ReaD 


DEC-standard error logging should be supported. 


A program to analyze the logged error information (even in its present reduced form) is 
needed. 


The partition tables for the file systems should be read off of each pack, as they are never quite 
what any single installation would prefer, and this would make packs more portable. 
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NAME 
hp — RPO06, RM03, RMOS, RM80, RPO7 MASSBUS moving-head disk 
SYNOPSIS 
disk hp0 at mba0 drive 0 
DESCRIPTION 
Files with minor device numbers 0 through 7 refer to various portions of drive 0; minor dev- 
ices 8 through 15 refer to drive 1, etc. The standard device names begin with ‘hp’ followed 


by the drive number and then a letter a-h for partitions 0-7 respectively. The character ? stands 
here for a drive number in the range 0-7. 


The origin and size of the pseudo-disks on each drive are as follows: 


RP06 partitions 


disk Start length — cyls 
hp’a 0 15884 0-37 
hp?b 15884 33440 38-117 
hp?c 0 340670 0-814 
hp?g 49324 291280 118-814 
RMO3 partitions 
disk Start length — cyls 
hp?a 0 15884 0-99 
hp?b 16000 33440 100-309 
hp’c 0 131680 0-822 
hp?g 49600 81984 310-822 
RMO5 partitions 
disk start length cyis 
hp’?a 0 15884 0-26 
hp ?b 16416 33440 27-81 
hp?c 0 500384 0-822 
hp?d 341696 15884 562-588 
hp’e 358112 $5936 589-680 
hp ?f 414048 86240 681-822 
hp?g 341696 158592 562-822 
hp 7h 49856 291346 82-561 
RM80 partitions 
disk Start length — cyils 
hp?a 0 15884 0-36 
hp?b 16058 33440 37-114 
hp?c 0 242606 0-558 
hp’g 49910 82080 115-304 
hp 7h 132370 §110143 305-558 
RPO7 partitions 
disk start length cyls 
hp?a 0 - 15884 0-9 
hp?b 16000 64000 10-49 
hp?c 0 1008000 0-629 
hp?d §28000 15884 330-339 
hp’?e 544000 258000 340-499 
hp ?f 800000 207850 500-629 
hp?g 528000 479850 330-629 
hp 7h 80000 448000 50-329 
A-15 
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It is unwise for ail of these files to be present in one installation, since there is overlap in 
addresses and protection becomes a sticky matter. The hp’a partition is normally used for the 
root file system, the hp%b partition as a paging area, and the hp?c partition for pack-pack copy- 
ing (it maps the entire disk). On rp06’s and rm03’s the hp2?g partition maps the rest of the 
pack. On rm80’s, rm05°s and rp07’s, both hp?g and hp?h are used to map the remaining 
cylinders. 


The block files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a ‘raw’ interface which pro- 
vides for direct transmission between the disk and the user’s read or write buffer. A single read 
or write call results in exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the raw files conventionally begin 
with an extra ‘r.’ 


In raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise seek calls should 
specify a multiple of 512 bytes. 


FILES 
/dev/hp (0-7) [a-h] block files 
/dev/rhp (0-7) {a-h] raw files 
SEE ALSO | 
hk (4), up (4) 
DIAGNOSTICS 


bp%d%c: hard error sn*ed mbsr=%b erl =%b er2=%b. An unrecoverable error occured dur- 
ing transfer of the specified sector of the specified disk partition. The MASSBUS status register 
is printed in hexadecimal and with the error bits decoded if any error bits other than MBEXC 
and DTABT are set. In any case the contents of the two error registers are also printed in octal 
and symbolically with bits decoded. (Note that er2 is what old rp06 manuals would call er3; the 
terminology is that of the rm disks). The error was either unrecoverable, or a large number of 
retry attempts (including offset positioning and drive recalibration) could not recover the error. 


hp%d: write locked The write protect switch was set on the drive when a write was attempted. 
The write operation is not recoverable. 


hp%d: not ready. The drive was spun down or off line when it was accessed. The i/o opera- 
tion is not recoverable. 


hp%d%c: soft ecc sn%d A recoverable ECC error occurred on the specified sector of the 
specified disk partition. This happens normally a few times a week. If it happens more fre- 
quently than this the sectors where the errors are occuring should be checked to see if certain 
cylinders on the pack, spots on the carriage of the drive or heads are indicated. 


BUGS 
In raw I/O readand write(2) truncate file offsets to 512-byte block boundaries, and write scrib- 
bies on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, 
read, writeand lseek(2) should always deal in 512-byte multiples. 


-DEC-standard error logging should be supported. 
Bad block forwarding is not yet supported on RP06’s. 


A program to analyze the logged error information (even in its present reduced form) is 
needed. 


The partition tables for the ‘file systems should be read off of each pack, as they are never quite 
what any single installation would prefer, and this would make packs more portable. 
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ht — TM-03/TE-16,TU-45,TU-77 MASSBUS magtape interface 


SYNOPSIS 


formatter ht0O at mba? drive ? 
tape tu0 at ht0 slave 0 


DESCRIPTION 


The tm-03/transport combination provides a standard tape drive interface as described in mr(4). 


All drives provide both 800 and 1600 bpi; the TE-16 runs at 45 ips, the TU-45 at 75 ips, while 
the TU-77 runs at 125 ips and autoloads tapes. 


SEE ALSO 


mt(1), tar(1), tp(1), mtop(4), mt(4), tm(4), ts(4) 


DIAGNOSTICS 


BUGS 


tu%d: no write ring. An attempt was made to write on the tape drive when no write ring was 
present; this message is written on the terminal of the user who tried to access the tape. 


tu%d: not online’ An attempt was made to access the tape while it was offline: this message is 
written on the terminal of the user who tried to access the tape. 


tu%d: can’t switch density in mid-tape. An attempt was made to write on a tape at a different 
density than is already recorded on the tape. This message is written on the terminal of the 
user who tried to switch the density. 


tu%d: hard error bn%d mbsr=%b er=%b ds=%b. A tape error occurred at block bm the ht 
error register and drive status register are printed in octal with the bits symbolically decoded. 
Any error is fatal on non-raw tape; when possible the driver will have retried the operation 
which failed several times before reporting the error. 


If any non-data error is encountered on non-raw tape, it refuses to do anything more until 
closed. 


The system should remember which controlling terminal has the tape drive open and write 
error messages to that terminal rather than on the console. 
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NAME 
Ip — line printer 
SYNOPSIS 
device Ip0 at uba0 csr 0177514 vector Ipintr 


DESCRIPTION 


Lp provides the interface to any of the standard DEC line printers. When it is opened or 
closed, a suitable number of page ejects is generated. Bytes written are printed. 


The unit number of the printer is specified by the minor device after removing the low 3 bits, 
which act as per-device parameters. Currently only the lowest of the low three bits is inter- 
preted: if it is set, the device is treated as having a 64-character set, rather than a full 96- 
character set. In the resulting half-ASCII mode, lower case letters are turned into upper case 
and certain characters are escaped according to the following table: 


( 
| az 


ws a 
emma 


The driver correctly interprets carriage returns, backspaces, tabs, and form feeds. Lines longer 
than 132 characters are truncated (This is a parameter in the driver). 


FILES 

/dev/\p 
SEE ALSO 

ipr (1) 
DIAGNOSTICS 

None. 


BUGS 
Although the driver supports multiple printers this has never been tried. In any case user-level 
software support for multiple printers is not available. 
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NAME 
mail — pseudo-device for mail notification 
DESCRIPTION 


The file /dev/mail is a multiplexor file maintained by the mail notification daemon. When a 
piece of mail is delivered the mail delivery process writes information on this file and the mai! 


notification daemon /etc/comsat notifies a user of the arrival of the mail if the user desires to 
be notified. 


SEE ALSO 
biff(1) 


FILES 
/dev/mail 


BUGS 
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NAME 
mem, kmem — main memory 


DESCRIPTION 
Mem is a special file that is an image of the main memory of the computer. It may be used, for 
example, to examine (and even to patch) the system. 


Byte addresses in mem are interpreted as physical memory addresses. References to non- 
existent locations cause errors to be returned. 


Examining and patching device registers is likely to lead to unexpected results when read-only 
or write-only bits are present. 


The file kmem is the same as mem except that kernel virtual memory rather than physical 
memory is accessed. 


On PDPi1's, the I/O page begins at location 0160000 of kmem and per-process data for the 
current process begins at 0140000. On VAX 11/780 the I/O space begins at physical address 
20000000(16); on an 11/750 I/O space addresses are of the form fxxxxx(16); on all VAX'en 
per-process data for the current process is at virtual 7ffff000(16). 


FILES 
/dev/mem, /dev/kmem 


BUGS 
On PDP11’s and VAX’s, memory files are accessed one byte at a time, an inappropiate method 
for some device registers. 
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mt — TM-78/TU-78 MASSBUS magtape interface 


SYNOPSIS 


formatter mt0 at mba? drive ? 
tape mu0O at mt0O slave 0 


DESCRIPTION 


The tm-78/transport combination provides a standard tape drive interface as described in 
mtop(4). The TU78 provides both 1600 and 6250 bpi, runs at 125 ips, and autoloads tapes. 


SEE ALSO 


mt(1), tar(1), tp(1), mtop(4), ht(4), tm(4), ts(4) 


DIAGNOSTICS 


BUGS 


mu%d: no write ring. An attempt was made to write on the tape drive when no write ring was 
present; this message is written on the terminal of the user who tried to access the tape. 


mu%d: not online.’ An attempt was made to access the tape while it was offline; this message is 
written on the terminal of the user who tried to access the tape. 


mu%d: can’t switch density in mid-tape.) An attempt was made to write on a tape at a 
different density than is already recorded on the tape. This message is written on the terminal 
of the user who tried to switch the density. 


mu%d: hard error bn%d mbsr=%b er=%o ds=%b._ A tape error occurred at block bm, the mt 
error register and drive status register are printed in octal with the drive status bits symbolically 
decoded.. Any error is fatal on non-raw tape; when possible the driver will have retried the 
operation which failed several times before reporting the error. 


mu%d: blank tape. An attempt was made to read or space a blank tape. 


If any non-data error is encountered on non-raw tape, it refuses to do anything more until 
closed. 


The system should remember which controlling terminal has the tape drive open and write 
error messages to that terminal rather than on the console. 
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mt — 


DESCRIPTION 

The files m0, ..., mti5 refer to the UNIX magtape drives, which may be on the MASSBUS 
using the TMO03 or TM78 formatters (4) or mi(4), or on the UNIBUS using either the TM11, 
TS11, or TU45 formatters wn(4), ts(4) or ut(4). The following description applies to any of the 
transport/controller pairs. The files m0, .... mt7 are low density, and mt8, ..., mtl5 are high 
density. On the TM0O3 and TM11 low density is 800bpi and high density is 1600bpi. On the 
TM78 low density is 1600bpi and high density is 6250bpi. On the TS11 both low and high den- 
sity are 1600bpi. The files mr0, ..., mt? and m1t&, ..., mtl] are rewound when closed; the others 
are not. When a file open for writing is closed, two end-of-files are written. If the tape is not 
to be rewound it is positioned with the head between the two tapemarks. 


UNIX magtape interface 


A standard tape consists of a series of 1024 byte records terminated by an end-of-file. To the 
extent possible, the system makes it possible, if inefficient, to treat the tape like any other file. 
Seeks have their usual meaning and it is possible to read or write a byte at a time. Writing in 
very small units is inadvisable, however, because it tends to create monstrous record gaps. 


The mit files discussed above are useful when it is desired to access the tape in a way compatible 
with ordinary files. When foreign tapes are to be dealt with, and especially when long records 
are to be read or written, the ‘raw’ interface is appropriate. The associated files are named 
rmto, ..., rmtl5, but the same minor-device considerations as for the regular files still apply. A 
number of other ioctl operations are available on raw magnetic tape. The following definitions 
are from <sys/mtio.h>: 


/* 
« Structures and definitions for mag tape io control commands 
a/ 


/* mag tape io control commands */ 
#define MTIOCTOP ((m’<<8)Il) /* doa mag tape op */ 
#define MTIOCGET ((m’<<8)2) /* get mag tape status */ 


/* structure for MTIOCTOP - mag tape op command */ 

struct mtop 
short mt_op; /* operations defined below */ 
daddr_t mt_count; /* how many of them #/ 


ie 


/* operations */ 
#define MTWEOF 
#define MTFSF 
#define MTBSF 
#define MTFSR 
#define MTBSR 
#define MTREW 
#define MTOFFL 


/»* write an end-of-file record «/ 

/* forward space file «/ 

/* backward space file «/ 

/«* forward space record */ 

/* backward space record +#/ 

/* rewind #/ 

/* rewind and put the drive offline a/ 
/* no operation, sets status only «/ 


/* structure for MTIOCGET - mag tape get status command */ 


struct mtget { 
short mt_type; /* type of magtape device */ 
/* the following two registers are grossly device dependent *«/ 


; 4.22 
4th Berkeley Distribution 10/8/81] 


MTOP (4) UNIX Programmer’s Manual MTOP (4) 


FILES 


short mt_dsreg; /* “drive status” register */ 
short mt_erreg; /* “error’’ register */ 

/* end device-dependent registers */ 
short mt_resid; /* residual count */ 

/* the following two are not yet implemented */ 
daddr_t mt_fileno, /* file number of current position */ 
daddr_t mt_blkno; /* block number of current position */ 


/* end not yet implemented */ 
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/s 

« Constants for mt_type byte 

«/ 

#define MT_ISTS 01 
#define MT_ISHT 02 
#define MT_ISTM 03 
#define MT_ISMT 04 
#define MT_ISUT 05 


Each read or write call reads or writes the next record on the tape. In the write case the record 
has the same length as the buffer given. During a read, the record size is passed back as the 
number of bytes read, provided it is no greater than the buffer size; if the record is long, an 
error is indicated. In raw tape I/O seeks are ignored. A zero byte count is returned when a 
tape mark is read, but another read will fetch the first record of the new tape file. 


/dev/mt?, /dev/rmt? 


SEE ALSO 


BUGS 


mt(1), tar(1), tp(1), ht(4), mt(4), tm(4), ts(4) 
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NAME 
newtty - summary of the ‘‘new”’ tty driver 


USAGE 
sity new 


sity new crt 


DESCRIPTION 
This is a summary of the new tty driver, described completely, with the old terminal driver, in 
ty(4). The new driver is largely compatible with the old but provides additional functionality 
for job control. 


CRTs and printing terminals. 


The new terminal driver acts differently on CRTs and on printing terminals. On CRTs at 
speeds of 1200 baud or greater it normally erases input characters physically with backspace- 
space-backspace when they are erased logically, at speed under 1200 baud this is often unrea- 
sonably slow, so the cursor is normally merely moved to the left. This is the behavior when 
you say “‘stty new crt’’; to have the tty driver always erase the characters say ‘‘stty new crt 
crterase crtkill’’, to have the characters remain even at 1200 baud or greater say ‘‘stty new crt 
—crterase ~crtkill’’. 


On printing terminals the commend ‘‘stty new prterase’’ should be given. Logically erased 
characters are then echoed printed backwards between a ‘\° and an ‘/° character. 


Other terminal modes are possible, but less commonly used: see ety(4) and srty(1) for details. 


ean @ 


laput editing and output control. 


When preparing input the character # (normally changed to “H using szry(1)) erases the last 
input character, “W the last input word, and the character @ (often changed to “U) erases the 
entire current input line. A “R character causes the pending input to be retyped. Lines are ter- 
minated by a return or a newline, a “D at the beginning of a line generates an end-of-file 


Control characters echo as “x when typed, for some x; the delete character is represented as ~?. 


The character “V may be typed before amy character so that it may be entered without its special 
effect. For backwards compatibility with the old tty driver the character ‘\’ prevents the special 
meaning of the character and line erase characters, much as “V does. 


Output is suspended when a “S character is typed and resumed when a “Q character is type. 
Output is discarded after a “O character is typed until another “O is type, more input arrives, or 
the condition is cleared by a program (such as the shell just before it prints a prompt.) 


Signals. 


A non-interactive program is interrupted by a ~? (delete); this character is often reset to “C 
using stty(1). A quit “\ character causes programs to terminate like “? does, but also causes a 
core image file to be created which can then be examined with a debugger. This is often used 
to stop runaway processes. Interactive programs often catch interrupts and return to their com- 
mand loop; only the most well debugged programs catch quits. 


Programs may be stopped by hitting “Z, which returns control to the shell. They may then be 
resumed using the job contro! mechanisms of the shell, i.e. the /g (foreground) command. The 
character “Y is like “Z but takes effect when read rather then when typed; it is much less fre- 
quentiy used. 


See sry(4) for a more complete description of the new terminal driver. 


SEE ALSO 
esh(1), newesh(1), stty(1), tty (4) 
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NAME 
null — data sink 

DESCRIPTION 
Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 


FILES 
{dev/null 
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NAME 
ra — UDAS0/RA80 Unibus disk controller and drives 


SYNOPSIS 
controller udaO at uba? csr 0177550 vector udintr 
disk raO at udaO drive 0 


DESCRIPTION 
The UDASO is an intelligent disk controller for the UNIBUS. It supports the RA80 124MB 
disk drive. 


Files with minor device numbers 0 through 7 refer to various portions of drive 0; minor dev- 
ices 8 through 15 refer to drive 1, etc. The standard device names begin with ‘“‘ra’’ followed by 
the drive number and then a letter a-h for partitions 0-7 respectively. The character ? stands 
here for a drive number in the range 0-7. 


The origin and size of the pseudo-disks on each drive are as follows: 
RA80 124M drive partitions: 


disk start length 
ra?a 0 15884 
ra?b 15884 33440 

’ ra?c 0 237298 
ra?d 0 0 
ra?e 0 0 
ra?f 0 0 


ra?g 49324 82080 
ra?h 131404 105994 


It is unwise for all of these files to be present in one installation, since there is overlap in 
addresses and protection becomes a sticky matter. The ra?a partition is normally used for the 
root file system, the ra?b partition as a paging area, and the ra?c partition for pack-pack copying 
(it maps the entire disk). Both ra?g and ra?h are used to map the remaining cylinders. 


The block files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a ‘raw’ interface which pro- 
vides for direct transmission between the disk and the user’s read or write buffer. A single read 
or write call results in exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the raw files conventionally begin 
with an extra ‘r.’ 


In raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise seek calls should 
specify a multiple of 512 bytes. 


FILES 

/dev/ra[0-7] [a-h] block files 

/dev/rral0-7] [a-h] raw files 
SEE ALSO 

hk (4), hp(4), up(4) 
DIAGNOSTICS 


ra%d%ec: hard error sn%d udasa %o, state %d. 

ra%d%c: hard error sn%d status %o. An unrecoverable error occured during transfer of the 
specified sector of the specified disk partition. The contents of the udasa register are printed in 
octal and symbolically with bits decoded. The internal state is also printed. In the second 
form, the MSCP status is printed. The error was either unrecoverable, or a large number of 
retry attempts (including offset positioning and drive recalibration) could not recover the error. 
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ra%d%c: hard error sn%d OFFLINE. The drive was spun down or off line when it was 
accessed. The i/o operation is not recoverable. 


uda%d: random interrupt ignored. The UDA received an interrupt before it was initialized. 


uda%d: fatal error (%o). A fatal error was noticed in the UDA interrupt routine. The con- 
tents of udasa are printed. The controller will be reinitialized. 


uda%d: [softhard! error, controller error, event 0%o. 

uda%d: [softhard] error, host memory access error, event 0%o, addr 0%o. 

uda%d: [softhard] error, disk transfer error, unit %d, grp %d, cyl %d, sec %d, trk %d, Ibn %d, 
retry “od, level “od. 

uda%d: [softhard! error, SDI error, unit %d, event 0%0o0, cyl %d. 

uda%d: [softhard] error, small disk error, unit %d, event 0%o, cy! %d. 

uda%d: {[softhard] error, unknown error, unit %d, format 0%0, event 0%o. 

See the driver and the UDA and MSCP manuals. 


BUGS 
In raw I/O readand write(2) truncate file offsets to 512-byte block boundaries, and write scrib- 
bles on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, 
read, writeand Iseek(2) should always deal in 512-byte multiples. 


A program to analyze the logged error information (even in its present reduced form) is 
needed. Error messages should be more consistent. 


The partition tables for the file systems should be read off of each pack, as they are never quite 
what any single installation would prefer, and this would make packs more portable. 


Dumps to the swap area on system crashes are not implemented. 


Booting via block zero is not (and will not be) supported. The ‘‘boot’’ program must be loaded 
from the console storage device. 


Although the device supports unit numbers up to 255, the driver only supports unit numbers 
up to 7. 
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rv ~ Racal/Vadic ACU interface 


DESCRIPTION 

The racal/vadic ACU interface is provided by the files /dev/cua/01/ which is a multiplexed file, 
and by the daemon dnd which monitors the file, simulating a standard DN dialer. To place an 
outgoing cail one forks a sub-process trying to open /dev/cul? and then opens the corresponding 
file /dev/cua? file and writes a number on it. The daemon translates the call to proper format 
for the Racal/Vadic interface, and monitors the progress of the call recording accounting infor- 
mation for later use. 


The codes for the phone numbers are the same as in the DN interface: 


0-9 dial 0-9 

: dial « 

: dial # 

= delay for second dial tone 
< end-of-number 


The entire telephone number must be presented in a single write system call. 
It is require that an end-of-number code be given. 


FILES 
/dev/cua0 virtual dialer for 300 baud dialout 
{dev/cual virtual dialer for 1200 baud dialout 
/dev/culd - the terminal which is connected to the 300 baud dialout 
/dev/cull the terminal which is connected to the 1200 baud dialout 
/usr/adm/dnacct Accounting records for sucessfully completed calls. 
SEE ALSO 
cu(1), uucp(1) 
BUGS 


Locking problems. 


The multiplexor seems to have rare-case bugs which occasinally crash the system taking trap 
type 9°s, usually in the sdara system routine. 
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tm — TM-11/TE-10 magtape interface 


SYNOPSIS 


controller tm0 at uba? csr 0172520 vector tmintr 
tape te0 at tm0 drive 0 


DESCRIPTION 


The tm-11/te-10 combination provides a standard tape drive interface as described in mt(4). 
Hardware implementing this on the VAX is typified by the Emulex TC-11 controller operating 
with a Kennedy model 9300 tape transport, providing 800 and 1600 bpi operation at 125 ips. 


SEE ALSO 


mt(1), tar(1), tp(1), ht(4), mt(4), ts(4) 


DIAGNOSTICS 


BUGS 


te%d: no write ring. An attempt was made to write on the tape drive when no write ring was 
present; this message is written on the terminal of the user who tried to access the tape. 


te%d: not online. An attempt was made to access the tape while it was offline; this message is 
written on the terminal of the user who tried to access the tape. 


te%d: can’t switch density in mid-tape. An attempt was made to write on a tape at a different 
density than is already recorded on the tape. This message is written on the terminal of the 
user who tried to switch the density. 


te%d: hard error bn%d er=%b. A tape error occurred at block 6b”, the tm error register is 
printed in octal with the bits symbolically decoded. Any error is fatal on non-raw tape; when 
possible the driver will have retried the operation which failed several times before reporting 
the error. 


te%d: lost interrupt. A tape operation did not complete within a reasonable time, most likely 
because the tape was taken off-line during rewind or lost vacuum. The controller should, but 
does not, give an interrupt in these cases. The device will be made available again after this 
message, but any current open reference to the device will return an error as the operation in 
progress aborts. 


If any non-data error is encountered on non-raw tape, it refuses to do anything more until 
closed. | 


The system should remember which controlling terminal has the tape drive open and write 
error messages to that terminal rather than on the console. 
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NAME 
ts — TS-11]1 magtape interface 
SYNOPSIS 
controller zsO at uba? csr 0172520 vector tsintr 
tape tsO at zsO drive 0 
DESCRIPTION 
The ts-11 combination provides a standard tape drive interface as described in mr(4). The ts-11 
operates only at 1600 bpi, and only one transport is possible per controller. 
SEE ALSO | 
mt(1), tar(1), tp(1), ht(4), mt(4), tm(4) 
DIAGNOSTICS 
ts%d: no write ring. An attempt was made to write on the tape drive when no write ring was 
present; this message is written on the terminal of the user who tried to access the tape. 
ts%d: not online’ An attempt was made to access the tape while it was offline; this message is 
written on the terminal of the user who tried to access the tape. 
ts%d: hard error bn%d xs0=%b. A hard error occurred on the tape at block db, status register 
0 is printed in octal and symbolically decoded as bits. 
BUGS »* 


If any non-data error is encountered on non-raw tape, it refuses to do anything more until 
closed. 

The device lives at the same address as a tm-!1 tm(4); as it is very difficult to get this device to 
interrupt, a generic system assumes that a ts is present whenever no tm-11 exists but the csr 
responds and a ts-11 is configured. This does no harm as long as a non-existant ts-11 is not 
accessed. 

The system should remember which controlling terminal has the tape drive open and write 
error messages to that terminal rather than on the console. 
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NAME 
tty — general terminal interface 


DESCRIPTION 


This section describes both a particular special file /dev/tty and the terminal drivers used for 
conversational computing. 


Line disciplines. 


The system provides different line disciplines for controlling communications lines. In this ver- 
sion of the system there are three disciplines available: 


old The old (standard) terminal driver. This is used when using the standard shell sA(1) 
and for compatibility with other standard version 7 UNIX systems. 


new A newer terminal driver, with features for job control; this must be used when using 
esh(1). See newety(1) for a short user-level summary. 


net A line discipline used for networking and loading data into the system over communi- 
cations lines. [t allows high speed input at very low overhead, and is described in 
bk (4). 


Line discipline switching is accomplished with the TIOCSETD ioctl: 
int Idise = LDISC; ioctl (filedes, TIOCSETD, &ldisc); 


where LDISC is OTTYDISC for the standard tty driver, NITTYDISC for the new driver and 
NETLDISC for the networking discipline. The standard (currently old) tty driver is discipline 0 
by convention. The current line discipline can be obtained with the TIOCGETD ioctl. Pending 
input is discarded when the line discipline is changed. 


All of the low-speed asynchronous communications ports can use any of the available line dis- 
ciplines, no matter what hardware is involved. The remainder of this section discusses the 
‘old”’ and ‘‘new’” disciplines. 


The control terminal. 


When a terminal file is opened, it causes the process to wait until a connection is established. 
In practice, user programs seldom open these files; they are opened by inir(8) and become a 
user’s standard input and output file. 


If a process which has no control terminal opens a terminal file, then that terminal file becomes 
the control terminal for that process. The control terminal is thereafter inherited by a child 
process during a fork(2), even if the control terminal is closed. 


The file /dev/tty is, in each process, a synonym for a control terminal associated with that pro- 
cess. It is useful for programs that wish to be sure of writing messages on the terminal no 
matter how output has been redirected. It can also be used for programs that demand a file 
name for output, when typed output is desired and it is tiresome to find out which terminal is 
currently in use. 


Process groups. 


As described more completely in jods(3), command processors such as csh(1) can arbitrate the 
terminal between different jobs by placing related jobs in a single process group and associating 
this es group lis the terminal. A terminals associated process group may be set using the 


fildes, TIOCSPGRP, &pegrp) 


or suelo using TIOCGPGRP rather than TIOCSPGRP, returning the current process group 
perp. The new terminal driver aids in this arbitration by restricting access to the termina! by 
sses which are not in the current process group, see Job access control below. 
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The terminal drivers have three major modes, characterized by the amount of processing on the 
input and output characters: 


cooked The normal mode. In this mode lines of input are collected and input editing is 
done. The edited line is made available when it is completed by a newline or when 
an EOT (control-D, hereafter “D) is entered. A carriage return is usually made 
synonymous with newline in this mode, and replaced with a newline whenever it is 
typed. All driver functions (input editing, interrupt generation, output processing 
such as delay generation and tab expansion, etc.) are available in this mode. 


CBREAK This mode eliminates the character, word, and line editing input facilities, making 
the input character available to the user program as it is typed. Flow control, 
literal-next and interrupt processing are still done in this mode. Output processing is 
done. 


RAW This mode eliminates all input processing and makes all input characters available as 
they are typed; no output processing is done either. 


The style of input processing can also be very different when, in the new terminal driver, a pro- 
cess asks for notification via a SIGTTIN signa/(2) when input is ready to be read from the con- 
trol terminal. In this case a read(2) from the control terminal will never block, but rather 
return an error indication (EIO) if there is no input available. 


Input editing. 


A UNIX terminal ordinarily operates in full-duplex mode. Characters may be typed at any 
time, even while output is occurring, and are only lost when the system’s character input 
buffers become completely choked, which is rare, or when the user has accumulated the max- 
imum allowed number of input characters that have not yet been read by some program. 
Currently this limit is 256 characters. In the old terminal driver ali the saved characters are 
thrown away when the limit is reached, without notice; the new driver simply refuses to accept 
any further input, and rings the terminal bell. 


Input characters are normally accepted in either even or odd parity with the parity bit being 
stripped off before the character is given to the program. By clearing either the EVEN or ODD 
bit in the flags word it is possible to have input characters with that parity discarded (see the 
Summary below.) 


In all of the line disciplines, it is possible to simulate terminal input using the TIOCSTT ioctl, 
which takes, as its third argument, the address of a character. The system pretends that this 
character was typed on the argument terminal, which must be the control terminal except for 
the super-user (this call is not in standard version 7 UNIX).. 


Input characters are normally echoed by putting them in an output queue as they arrive. This 
may be disabled by clearing the ECHO bit in the flags word using the stty(2) call or the 
TIOCSETN or TIOCSETP ioctis (see the Summary below). 


In cooked mode, terminal input is processed in units of lines. A program attempting to read 
will normally be suspended until an entire line has been received (but see the description of 
SIGTTIN in Modes above and FIONREAD in Summary below.) No matter how many charac- 
ters are requested in the read call, at most one line will be returned. It is not, however, neces- 
sary to read a whole line at once; any number of characters may be requested in a read, even 
one, without losing information. 


During input, line editing is normally done, with the character ‘#’ logically erasing the last 
character typed and the character °“@’ logically erasing the entire current input line. These are 
often reset on crt’s, with “H replacing #, and “U replacing @. These characters never erase 
beyond the beginning of the current input line or an “D. These characters may be entered 
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literally by preceding them with ‘\’; in the old teletype driver both the ‘\’ and the character 
entered literally will appear on the screen; in the new driver the ‘\’ will normally disappear. 


The drivers normally treat either a carriage return or a newline character as terminating an 
input line, replacing the return with a newline and echoing a return and a line feed. If the 
CRMOD bit is cleared in the local mode word then the processing for carriage return is dis- 
abled, and it is simply echoed as a return, and does not terminate cooked mode input. 


In the new driver there is a literal-next character “V which can be typed in both cooked and 
CBREAK mode preceding amy character to prevent its special meaning. This is to be preferred 
to the use of ‘\" escaping erase and kill characters, but ‘\’ is (at least temporarily) retained with 
its old function in the new driver for historical reasons. 


The new terminal driver also provides two other editing characters in normal mode. The 
word-erase character, normally “W, erases the preceding word, but not any spaces before it. 
For the purposes of “W, a word is defined as a sequence of non-blank characters, with tabs 
counted as blanks. Finally, the reprint character, normally “R, retypes the pending input begin- 
ning on a new line. Retyping occurs automagically in cooked mode if characters which would 
normally be erased from the screen are fouled by program output. 


Input echoing and redisplay 


In the old terminal driver, nothing special occurs when an erase character is typed; the erase 
character is simply echoed. When a kill character is typed it is echoed followed by a new-line 
(even if the character is not killing the line, because it was preceded by a ‘\"!.) 


The new terminal driver has several modes for handling the echoing of terminal input, con- 
trolled by bits in a local mode word. 


Hardcopy terminals. When a hardcopy terminal is in use, the LPRTERA bit is normally set in 
the local mode word. Characters which are logically erased are then printed out backwards pre- 
ceded by ‘\’ and followed by ‘/’ in this mode. 


Crr terminals. When a crt terminal is in use, the LCRTBS bit is normally set in the local mode 
word. The terminal driver then echoes the proper number of erase characters when input is 
erased: in the normal case where the erase character is a -H this causes the cursor of the termi- 
nal to back up to where it was before the logically erased character was typed. If the input has 
becorne fouled due to interspersed asynchronous output, the input is automagically retyped. 


Erasing characters from a crt. When a crt terminal is in use, the LCRTERA bit may be set to 
cause input to be erased from the screen with a ‘‘backspace-space-backspace’’ sequence when 
character or word deleting sequences are used. A LCRTKIL bit may be set as well, causing the 
input to be erased in this manner on line kill sequences as well. 


Echoing of control characters. If the LCTLECH bit is set in the local state word, then non- 
printing (control) characters are normally echoed as “X (for some X) rather than being echoed 
unmodified, delete is echoed as ~?. 


The normal modes for using the new terminal driver on crt terminals are speed dependent. At 
speeds less than 1200 baud, the LCRTERA and LCRTKILL processing is painfully slow, so 
sttv(1) normally just sets LCRTBS and LCTLECH; at speeds of 1200 baud or greater all of 
these bits are normally set. Smy(1) summarizes these option settings and the use of the new 
terminal driver as ‘‘newcrt.” 


When one or more s@haraciers are written, they are actually transmitted to the terminal as soon 
as previously-written characters have finished typing. (As noted above, input characters are 
normally echoed by putting them in the output queue as they arrive.) When a process produces 
characters) more rapidly than they can be typed, it will be suspended when its output queue 

is som When the queue has drained down to some threshold the program Is 
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resumed. Even parity is normally generated on output. The EOT character is not transmitted 
in cooked mode to prevent terminals that respond to it from hanging up; programs using raw or 
cbreak mode should be careful. 


The terminal drivers provide necessary processing for cooked and CBREAK mode output 
including delay generation for certain special characters and parity generation. Delays are 
available after backspaces “H, form feeds “L, carriage returns “M, tabs “I and newlines “J. The 
driver will also optionally expand tabs into spaces, where the tab stops are assumed to be set 
every eight columns. These functions are controlled by bits in the tty flags word; see Summary 
below. 


The terminal drivers provide for mapping between upper and lower case on terminals lacking 
lower case, and for other special processing on deficient terminals. 


Finally, in the new terminal driver, there is a output flush character, normally “O, which sets 
the LFLUSHO bit in the local mode word, causing subsequent output to be flushed until it is 
cleared by a program or more input is typed. This character has effect in both cooked and 
CBREAK modes and causes pending input to be retyped if there is any pending input. Ioctis to 
flush the characters in the input and oulpnt queues TIOCFLUSH, and to return the number of 


character still in the output queue TIOCOUTQ are also available. 


Upper case terminals and Hazeitines 


If the LCASE bit is set in the tty flags, then all upper 
corresponding lower-case letter. Th ise letter mat 
If the new terminal driver is bein MSEC ue upper ¢ 
output. In addition, the following escape se 

on input: 

for . . { } 

use a \! ee \ ( \) 

To deal with Hazeltine tern oo which do not understand that ~ has been made into an ASCII 
character, the LTILDE bit may be set in the local mode word when using the new terminal 
driver; in this case the ace ” will be replaced with the character “on output. 


-case letters are mapped into the 
be generated by preceding it by ‘\’. 
letters are preceded by a ‘\’ when 
be generated on output and accepted 


Flow control. 


There are two characters (the st0P character, normally “S, and the start character, normally “Q) 
which cause output to be pended and resun ned respectively. Extra stop characters typed 
when output is already Seed: have no effect, unless the start and stop characters are made the 
Same, in which case output resumes. 


A bit in the flags word may be set to put the terminal into TANDEM mode. In this mode the 
system produces a stop character (default “S) when the input queue is in danger of overflowing, 
and a start character (default “Q) when the input has drained sufficiently. This mode is useful 
when the terminal is actually another machine that obeys the conventions. 


Line control and breaks. 


There are several joce/ calls available to control the state of the terminal line. The TIOCSBRK 
ioctl will set the break bit in the hardware interface causing a break condition to exist; this can 
be cleared (usually after a delay with sileep(3)) by TIOCCBRK. Break conditions in the input 
are reflected as a null character in RAW mode or as the interrupt character in cooked or 
CBREAK mode. The TIOCCDTR iocu will clear the data terminal ready condition; it can be 
set again by TIOCSDTR.. 


When the carrier signal from the dataset drops (usually because the user has hung up his termi- 
nal) a SIGHUP hangup signal is sent to the processes in the distinguished process group of the 
terminal; this usually causes them to ter: 


minate (the SIGHUP can be suppressed by setting the 


LNOHANG bit in the local state word of the driver.) Access to the terminal by other processes 
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is then normally revoked, so any further reads will fail, and programs that read a terminal and 
test for end-of-file on their input will terminate appropriately. 


When using an ACU it is possible to ask that the phone line be hung up on the last close with 
the TIOCHPCL ioctl; this is normally done on the outgoing line. 


Interrupt characters. 


There are several characters that generate interrupts in cooked and CBREAK mode; all are sent 
the processes in the control group of the terminal, as if a TIOCGPGRP ioctl were done to get 
the process group and then a killpg(2) system call were done, except that these characters also 
flush pending input and output when typed at a terminal (4 ‘la TIOCFLUSH). The characters 
shown here are the defaults; the field names in the structures (given below) are also shown. 
The characters may be changed, although this is not often done. 


aa t_intre (Delete) generates a SIGINTR signal. This is the normal way to stop a process 
which is no longer interesting, or to regain control in an interactive program. 

B t_quite (FS) generates a SIGQUIT signal. This is used to cause a program to terminate 
and produce a core image, if possible, in the file core in the current directory. 

"Z t_suspe (EM) generates a SIGTSTP signal, which is used to suspend the current pro- 
cess group. 

i 4 t_dstope (SUB) generates a SIGTSTP signal as “Z does, but the signal is sent when a 


program attempts to read the “Y, rather than when it is typed. 
ccess control. 


When using the new terminal driver, if a process which is not in the distinguished process 

group of its control terminal attempts to read from that terminal its process group is sent a 
SIG TIN signal, which normally causes the members of that process group to stop. If, how- 
ever, the process is ignoring or holding SIGTTIN signal is an orphan its parent has exited and 
it has been inherited by the init(8) process, or if it is a process in the middle of process creation 
using vfork(2)), it is instead returned an end-of-file. Under older UNIX systems these 
processes would typically have had their input files reset to /dev/null, so this is a compatible 
change. 


When using the new terminal driver with the LTOSTOP bit set in the local modes, a process is 
prohibited from writing on its control terminal if it is not in the distinguished process group for 
that terminal. Processes which are holding or ignoring SIGTTOU signals, which are orphans, or 
which are in the middle of a vfork(2) are excepted and allowed to produce output. 


Summary of modes. 


Unfortunately, due to the evolution of the terminal driver, there are 4 different structures 
which contain various portions of the driver data. The first of these (sgttyb) contains that part 
of the information largely common between version 6 and version 7 UNIX systems. The 
second contains additional contro! characters added in version 7. The third is a word of local 
state peculiar to the new terminal driver, and the fourth is another structure of special charac- 
ters added for the new driver. In the future a single structure may be made available to pro- 
grams which need to access all this information, most programs need not concern themselves 
with ail this state. 


The basic jocrs use the structure defined in < sgrry.A>: 


struct sgttyb { 
ener Sages 
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sg_ flags; 


sg_ispeed and sg ospeed fields describe the input and output speeds of the device according 
ie ay ae table, which corresponds to the DEC DH-11 interface. If other hardware is 
Joe ose speed changes are ignored. Symbolic values in the table are as defined in 


(hang up dataphone) 
50 baud 


B4800 12 4800 baud 
B9600 13 9600 baud 
EXTA 14 External A 
EXTB 15 _ External B 


In the current configuration, only 110, 150, 300 and 1200 baud are really supported on dial-up 
lines. Code conversion and line control required for IBM 2741°s (134.5 baud) must be imple- 
mented by the user’s program. The half-duplex line discipline required for the 202 dataset 
(1200 baud) is not supplied; full-duplex 212 datasets work fine. 


The sg erase and sg kill fields of the argument structure specify the erase and kill characters 
respectively. (Defaults are # and @.) : 


The sg flags field of the argument structure contains several bits that determine the system's 
treatrnent of the terminal: 


ALLDELAY rae bag Delay algorithm selection 
00000 Select backspace delays (not implemented): 


0040000 Select form-feed and vertical-tab delays: 
FFO 0 

CRDELAY 0030000 Select carriage-return delays: 
aed 


NLO 


4th Berkeley Distribution 4-36 


TTY (4) UNIX Programmer's Manual ITY (4) 


NL! 

NL2 

NL3 

EVENP 0000200 Even parity allowed on input (most terminals) 
ODDP 0000100 Odd parity allowed on input 

RAW 0000040 Raw mode: wake up on all characters, 8-bit interface 
CRMOD 0000020 Map CR into LF. echo LF or CR as CR-LF 

ECHO 0000010 Echo (full duplex) 


LCASE 0000004 Map upper case to lower on input 
CBREAK 0000002 Return each character as soon as typed 
TANDEM 0000001 Automatic flow control 


The delay bits specify how long transmission stops to allow for mechanical or other movement 
when certain characters are sent to the terminal. In all cases a value of 0 indicates no delay. 


Backspace delays are currently ignored but might be used for Terminet 300’s. 
If a form-feed/vertical tab delay is specified, it lasts for about 2 seconds. 


Carriage-return delay type 1 lasts about .08 seconds and is suitable for the Terminet 300. Delay 
type 2 lasts about .16 seconds and is suitable for the VT0S and the Tl 700. Delay type 3 is suit- 
able for the concept-100 and pads lines to be at least 9 characters at 9600 baud. 


New-line delay type 1 is dependent on the current column and is tuned for Teletype mode! 
37's. Type 2 is useful for the VTOS5 and is about .10 seconds. Type 3 is unimplemented and is 
0. 


Tab delay type | is dependent on the amount of movement and is tuned to the Teletype mode! 
37. Type 3, called XTABS, is not a delay at all but causes tabs to be replaced by the appropri- 
ate number of spaces on output. 


Input characters with the wrong parity, as determined by bits 200 and 100, are ignored in 
cooked and CBREAK mode. 


RAW disables all processing save output flushing with LFLUSHO; full 8 bits of input are given 
as soon as it is available, all 8 bits are passed on output. A break condition in the input is 
reported as a null character. If the input queue overflows in raw mode it is discarded, this 
applies to both new and old drivers. 


CRMOD causes input carriage returns to be turned into new-lines; input of either CR or LF 
causes LF-CR both to be echoed (for terminals with a new-line function). 


CBREAK is a sort of half-cooked (rare?) mode. Programs can read each character as soon as 
typed, instead of waiting for a full line; all processing is done except the input editing: character 
and word erase and line kill, input reprint, and the special treatment of \ or EOT are disabled. 


TANDEM mode causes the system to produce a stop character (default “S) whenever the input 
queue is in danger of overflowing, and a start character (default “Q) when the input queue has 
drained sufficiently. It is useful for flow control when the ‘terminal’ is really another computer 
which understands the conventions. | 


In addition to the TIOCSETD and TIOCGETD disciplines discussed in Line disciplines above, 
a large number of other jocr/(2) calls apply to terminals, and have the general form: 
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The applicable codes are: 


TIOCGETP Fetch the basic parameters associated with the terminal, and store in the 
pointed-to sgrrd structure. 


‘Set the parameters according to the pointed-to sgrryd structure. The interface 
delays until output is quiescent, then throws away any unread characters, 
before changing the modes. 


TIOCSETN Set the parameters like TIOCSETP but do not delay or flush input. Input is 
not preserved, however, when changing to or from RAW. 


With the following codes the arg is ignored. 


TIOCEXCL Set “‘exclusive-use’’ mode: no further opens are permitted until the file has 
been closed. : 


TIOCNXCL Turn off ‘‘exclusive-use’’ mode. 


TIOCHPCL When the file is closed for the last time, hang up the terminal. This is useful 
when the line is associated with an ACU used to place outgoing cails. 


TIOCFLUSH _ All characters waiting in input or output queues are flushed. 


The remaining calls are not available in vanilla version 7 UNIX. In cases where arguments are 
required, they are described; argshould otherwise be given as 0. 


TIOCSTI the argument is the address of a character which the system pretends was typed 
on the terminal. 


TIOCSBRK the break bit is set in the terminal. 
TIOCCBRK the break bit is cleared. 
TIOCSDTR data terminal ready is set. 
TIOCCDTR data terminal ready is cleared. 


TIOCGPGRP arg is the address of a word into which is placed the process group number of 
the contro! terminal. 


TIOCSPGRP arg is a word (typically a process id) which becomes the process group for the 
control terminal. 


FIONREAD returns in the long integer whose address is arg the number of immediately 
readable characters from the argument unit. This works for files, pipes, and 
terminals, but not (yet) for multiplexed channels. 

Tchars 

The second structure associated with each terminal specifies characters that are special in both 

the cold and new terminal interfaces: The following structure is defined in < sysfoct.A>, which 

is automaticaily included in < sgmy.h>: 


struct tchars { 


char = t_intre; /* interrupt ¢/ 

char t_quite; /e quit */ 

char  t_starte; / start output */ 

char ¢_stope; /* stop output */ 

char t_eofe; /e end-of-file «/ 

char  t_brkc; /* input delimiter (like nl) «/ 


ki 

The default values for these characters are “?, “\, “Q, “S, “D, and ~—1. A character value of 
~1 eliminates the effect of that character. The ¢ drkc character, by default —1, acts like a 
new-line in that it terminates a ‘line,’ is echoed, and is passed to the program. The ‘stop’ and 
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‘start’ characters may be the same, to produce a toggle effect. It is probably counterproductive 


to make other special characters (including erase and kill) identical. The applicable ioctl calls 
are: 


TIOCGETC Get the special characters and put them in the specified structure. 
TIOCSETC Set the special characters to those given in the structure. 
Local mode 


The third structure associated with each terminal is a local mode word; except for the 


LNOHANG bit, this word is interpreted only when the new driver is in use. The bits of the 
local mode word are: 


LCRTBS 000001 Backspace on erase rather than echoing erase 
LPRTERA 000002 Printing terminal erase mode | 
LCRTERA 000004 Erase character echoes as backspace-space-backspace 
LTILDE 000010 Convert ~ to ‘on output (for Hazeltine terminals) 
LMDMBUF 000020 Stop/start output when carrier drops 

LLITOUT 000040 Suppress output translations 

LTOSTOP 000100 Send SIGTTOU for background output 

LFLUSHO 000200 Output is being flushed 

LNOHANG 000400 Don’t send hangup when carrier drops 

LETXACK 001000 Diablo style buffer hacking (unimplemented) 
LCRTKIL 002000 BS-space-BS erase entire line on line kill 

LINTRUP 004000 Generate interrupt SIGTINT when input ready to read 
LCTLECH 010000 Echo input control chars as “X, delete as ~? 
LPENDIN 020000 Retype pending input at next read or input character 
LDECCTQ 040000 Only “Q restarts output after “S, like DEC systems 


The applicable jocrffunctions are: 

TIOCLBIS arg is the address of a mask which is the bits to be set in the local mode word. 
TIOCLBIC arg is the address of a mask of bits to be cleared in the local mode word. 
TIOCLSET arg is the address of a mask to be placed in the local mode word. 

TIOCLGET arg is the address of a word into which the current mask is placed. 


Loca! special chars 


The final structure associated with each terminal is the /tchars structure which defines interrupt 
characters for the new terminal driver. Its structure Is: 


struct Ite 
¢t_suspe; /* stop process signal */ 
t_dstope; /e delayed stop process signal */ 
t_rprntc; /e reprint line °/ 
t_flushc; /e flush output (toggles) «/ 
¢_werasec; /e word erase */ 
t_Inexte; /e literal next character ¢/ 


}; 


The default values for these characters are “Z, “Y, “R, “O, “W, and “V. A value of —1 disables 
the character. | 
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The applicable foct/ functions are: 


TIOCSLTC args is the address of a /tchars structure which defines the new local special charac- 
ters. 


TIOCGLTC args is the address of a /tchars structure into which is placed the current set of 
local special characters. 
FILES 
/dev/ tty 
/dev/tty 
/dev/console 
SEE ALSO 
csh(1), stty(1), ioct!(2), signal(2), sigsys(2), stty(2), getty (8), init(8), newtty (4) 
BUGS 
Half-duplex terminals are not supported. 
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NAME 
tu — console TU58 interface 

DESCRIPTION 
This is a simple interface to the TU58 cassette tape unit, which is part of the console subsytem 
for VAX-11/750’s. Access is given to the entire tape consisting of 1024 blocks of 512 bytes. 
The TU58 behaves like a disk but has only a block interface (no raw). The cassette is com- 
monly accessed via the arf(8) command, using the ‘m’ flag. 

FILES 
/dev/ floppy 

SEE ALSO 
arff(8) 

DIAGNOSTICS 
Lots, mostly cryptic. Read the driver. 

BUGS 


The driver is very unreliable due to the nature of the TU58 interface. The TU58 should be 
used only when the system is in single-user mode, since it is often necessary to reboot the sys- 
tem to unhang the process accessing the TUS8. 


‘ 
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up - unibus storage module controller/drives 


SYNOPSIS 


controller scO at uba? csr 0176700 vector upintr 
disk upO at scO drive 9 


DESCRIPTION é 


FILES 


This is a generic UNIBUS storage module disk driver. It is specifically designed to work with 
the Emulex SC-21 controller and Ampex or CDC 300M or Fujitsu 160M drives. It can be 
easily adapted to other drives and controllers (although bootstrapping will not necessarily be 
directly possible.) 

Files with minor device numbers 0 through 7 refer to various portions of drive 0; minor dev- 
ices 8 through 15 refer to drive 1, etc. The standard device names begin with ‘“‘up’’ followed 
by the drive number and then a letter a-h for partitions 0-7 respectively. The character ? stands 
here for a drive number in the range 0-7. 

The origin and size of the pseudo-disks on each drive are as follows: 


AMPEX/CDC 300M drive partitions: 


disk Start iength cyl 

up ?a 0 15884 0-26 
up 7b 16416 33440 27-81 
up?c 0 49§320 0-814 


up?d 341696 15884  $62-588 
up’e 358112 55936 589-680 
up ?f 414048 81472 681-814 
up ?g 341696 153824 562-814 
up?h 49856 291346 82-561 


FUJITSU 160M drive partitions: 


disk Start length cyl 
. 0 1$884 0-49 
16000 33440 50-154 
0 263360 0-822 


49600 213760 155-822 


It is unwise for all of these files to be present in one installation, since there is overlap in 
addresses and protection becomes a sticky matter. The up?a partition is normally used for the 
root file system, the up?b partition as a paging area, and the up?c partition for pack-pack copy- 
ing (it maps the entire disk). On 160M drives the up?h partition maps the rest of the pack. 
On 300M drives both up?g and up?h are used to map the remaining cylinders. 


The block files access the disk via the system’s normal buffering mechanism and may be read 
and written without regard to physical disk records. There is also a ‘raw’ interface which pro- 
vides for direct transmission between the disk and the user’s read or write buffer. A single read 
or write call results in exactly one I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the raw files conventionally begin 
with an extra ‘r.’ 


In raw I/O counts should be a multiple of 512 bytes (a disk sector). Likewise seek calls should 
specify a multiple of 512 bytes. 


/dev/up (0-7) {a-h] block files 
/dev/rup [0-7] {a-h] raw files 
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SEE ALSO 
hk (4), hp(4) 


DIAGNOSTICS 


up%ed%ec: hard error sn%d cs2=%b erl =%b er2=%b. An unrecoverable error occured during 
transfer of the specified sector of the specified disk partition. The contents of the cs2, erl and 
er2 registers are printed in octal and symbolically with bits decoded. The error was either unre- 


coverable, or a large number of retry attempts (including offset positioning and drive recalibra- 
tion) could not recover the error. 


up%d: write locked. The write protect switch was set on the drive when a write was attempted. 
The write operation is not recoverable. 


up%d: not ready. The drive was spun down or off line when it was accessed. The i/o operation 
is not recoverable. 


up%d: not ready (came back!). The drive was not ready, but after printing the message about 


being not ready (which takes a fraction of a second) was ready. The operation is recovered if 
no further errors occur. 


up’d%e: soft ecc sn%d. A recoverable ECC error occurred on the specified sector of the 
specified disk partition. This happens normally a few times a week. If it happens more fre- 
quently than this the sectors where the errors are occuring should be checked to see if certain 
cylinders on the pack, spots on the carriage of the drive or heads are indicated. 


se%d: lost interrupt. A timer watching the controller detecting no interrupt for an extended 
period while an operation was outstanding. This indicates a hardware or software failure. 
There is currently a hardware/software problem with spinning down drives while they are being 
accessed which causes this error to occur. The error causes a UNIBUS reset, and retry of the 


pending operations. If the controller continues to lose interrupts, this error will recur a few 
seconds later. 


BUGS 
In raw I/O read and write(2) truncate file offsets to 512-byte block boundaries, and write scrib- 


bles on the tail of incomplete blocks. Thus, in programs that are likely to access raw devices, 
read, writeand Iseek(2) should always deal in 512-byte multiples. 


DEC-standard error logging and bad block forwarding should be supported; the code to do this 
could be easily incorporated from the Ap(4) driver. All that would be needed then would be a 
stand-alone formatting program to detect the bad sectors, format the disk so that the sectors 
were marked bad and initialize the bad sector files. 


A program to analyze the logged error information (even in its present reduced form) is 
needed. 


The partition tables for the file systems should be read off of each pack, as they are never quite 
what any single installation would prefer, and this would make packs more portable. 
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NAME 
va ~ Benson- Varian interface 
SYNOPSIS 
device va0 at uba? csr 0164000 vector vaintr 
DESCRIPTION 
The Benson-Varian printer/plotter in normally used with the programs vpr(1), vprinr(1) or 
viroffl) . This description is designed for those who wish to drive the Benson-Varian directly. 


The Benson-Varian at Berkeley uses 11°” by 8°’ fan-fold paper. It will print 132 characters per 
line in print mode and 2112 dots per line in plot mode. 


In print mode, the Benson-Varian uses a modified ASCII character set. Most control characters 
print various non-ASCII graphics such as.daggers, sigmas, copyright symbols, etc. Only LF and 
FF are used as format effectors. LF acts as a newline, advancing to the beginning of the next 
line, and FF advances to the top of the next page. 


In plot mode, the Benson-Varian prints one raster line at a time. An entire raster line of bits 
(2112 bits = 264 bytes) is sent, and then the Benson-Varian advances to the next raster line. 


Note: The Benson-Varian must be sent an even number of bytes. If an odd number is sent, 
the last byte will be lost. Nulls can be used in print mode to pad to an even number of bytes. 


To use the Benson-Varian yourself, you musi realize that you cannot open the device, /devAad 
if there is a daemon active. You can see if there is a daernon active by doing a ps(1), or by 
looking in the directory Ausr/spoolved. If there is a file lock there, then there is probably a dae- 
mon /usr/ib’ad running. If not, you should remove the /ock. 


In any case, when your program tres to open the device /devAa0 you may get one of two 
errors. The first of these ENXIO indicates that the Benson-Varian is already in use. Your pro- 
gram can then sleep(2) and try again in a while, or give up. The second is EJO and indicates 
that the Benson- Varian is offline. 


To set the Benson-Varian into plot mode, ‘“‘#include <vcmd.h>’’ and use the following 
iocti(2) call . 


ioctl (fileno(va), VSETSTATE, plotmd), 
where plotmd is defined to be 
int plotmd{] = { VPLOT, 0, 0}; 


and vais the resuit of a call to fopen on stdio. When you finish using the Benson-Varian in piot 
mode you should advance to a new page by sending it a FF after putting it back into print 
mode, 1.e. by 


int prtmd({] = { VPRINT, 0, 0}; 


flush (va): 
ioctl (fileno(va), VSETSTATE, prtmd),; 
write (fileno(va), “\f\0", 2); 


N.B.: If you use the standard I/O library with the Benson- Varian you must do 
setbuf (vp, vpbuf); 

where vpbu/is declared 
char vpbuf {[BUFSIZ]. 


otherwise the standard I/O library, thinking that the Benson-Varian is a terminal (since it is a 
character special file) will not adequately buffer the data you are sending to the Benson- Varian 
This will cause it to rum extremely slowly and tend to grind the system to a halt. 
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FILES 
/dev/va0 
/usr/include/sys/vcmd.h 
SEE ALSO 
vfont(5), vpr(1), vtroff(1), vp(4) 
DIAGNOSTICS 


va%d: npr timeout. The device was not able to get data from the UNIBUS within the timeout 

period, most likely because some other device was hogging the bus. (But see BUGS below). 

BUGS | 
The 1’s (one’s) and 1’s (lower-case el’s) in the Benson-Varian’s standard character set look very 
similar, caution ts advised. 


The interface hardware is rumored to have problems which can play havoc with the UNIBUS. 
We have intermittent minor problems on the UNIBUS where our va lives, but haven't ever 
been able to pin them down completely. 
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NAME 
vp — Versatec interface 
SYNOPSIS 
device vp0 at uba? csr 0177510 vector vpintr vpintr 
DESCRIPTION 
The Versatec printer/plotter is normally used with the programs vpr(1), vprint(1) or vtrogf(1). 
This description is designed for those who wish to drive the Versatec directly. 


The Versatec at Berkeley is 36°" wide, and has 440 characters per line and 7040 dots per line in 
plot mode (this is actually slightly less than 36°’ of dots.) The paper used is continuous roll 
paper, and comes in 500’ rolls. 


To use the Versatec yourself, you must realize that you cannot open the device, /dev/vp0 if 
there is a daemon active. You can see if there is a daemon active by doing a ps(1), or by look- 
ing in the directory /usr/spooivpd. If there is a file lock there, then there is probably a daemon 
/usrfibvpd running. If not, you should remove the Jock. 


In any case, when your program tries to open the device dev/vp0 you may get one of two errors. 
The first of these ENXIO indicates that the Versatec is already in use. Your program can then 
sleep(2) and try again in a while, or give up. The second is EIO and indicates that the Versatec 
is offline. 
To set the Versatec into plot mode you should include <vcmd.h> and use the jocr/(2) call 

ioctl (fileno(vp), VSETSTATE, plotmd), 
where plotmd is defined to be 

int plotmd[] = { VPLOT, 0, 0}; 
and vpis the result of a call to fopen on stdio. When you finish using the Versatec in plot mode 
you should eject paper by sending it a EOT after putting it back into print mode, i.e. by 


int prtmd{] = ( VPRINT, 0, 0}; 


flush (vp). 
ioctl (fileno(vp), VSETSTATE, prtmd), 
write (fileno(vp), “\04", 1); 
N.B.: If you use the standard I/O library with the Versatec you must do 
setbuf(vp, vpbuf); 
where vpbufis declared 
char vpbuf(BUFSIZ). 
otherwise the standard I/O library, thinking that the Versatec is a terminal (since it is a charac- 


ter special file) will not adequately buffer the data you are sending to the Versatec. This will 
cause it to run extremely slowly and tends to grind the system to a halt. 


FILES 
/dev/vp0 
SEE ALSO 
vfont(5), vpr(1), vtroff(1), va(4) 
DIAGNOSTICS 
None. 
BUGS 


The configuration part of the driver assumes that the device is setup to vector print mode 
through 0174 and plot mode through 0200. Since the driver doesn’t care whether the device 
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considers the interrupt to be a print or a plot interrupt, it would be preferable to have these be 
the same. This since the configuration program can't be sure at boot time which vector inter- 
rupted and where the interrupt vectors actually are. For the time being, since our versatec is 
vectored as described above, we specify that it has two interrupt vectors and are careful to 


detect an interrupt through 0200 at boot time and (manually) pretend the interrupt came 
through 0174. 
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NAME 


a.out — assembler and link editor output 


SYNOPSIS 


#include <a.out.h> 


DESCRIPTION 


A.outis the output file of the assembler a@s(1) and the link editor /d(1). Both programs make 
a.out executable if there were no errors and no unresolved external references. Layout infor- 
mation as given in the include file for the VAX-11 is: 
je 
* Header prepended to each a.out file. 
o/ 
struct exec { 
long a_magi¢;, /* magic number «/ 
unsigned a_text; /* size of text segment */ 
unsigned a_data,; /* size of initialized data +/ 
unsigned a_bss; /* size of uninitialized data °/ 
unsigned a_syms; /* size of symbol table »/ 
unsigned a_entry, /* entry point ¢/ 
unsigned a_trsize, /* size of text relocation «/ 
unsigned a_drsize; /* size of data relocation «/ 


i 


#define OMAGIC 0407 /* old impure format ¢/ 
#define NMAGIC 0410 /* read-only text */ 
#define ZMAGIC 0413 /* demand load format #/ 


/s 
« Macros which take exec structures as arguments and tell whether 
* the file has a reasonable magic number or offsets to text|symbols|strings. 
«/ 
#define N_BADMAG(x) \ 
(((x).a_magic)!=OMAGIC && ((x).a_magic)!=NMAGIC && ((x).a_magic)!=ZMAGIC) 


#define N_TXTOFF(x) \ 

((x).a_magic= =ZMAGIC ? 1024 : sizeof (struct exec)) 
#define N SYMOFF(x) \ 

(N_TXTOFF(x) + (x).a_text+(x).a_data + (x).a_trsize + (x).a_drsize) 
#define N_STROFF(x) \ 

(N_SYMOFF(x) + (x).a_syms) 


The file has five sections: a header, the program text and data, relocation information, a symbol 
table and a string table (in that order). The last three may be omitted if the program was 
loaded with the ‘—s’ option of /d or if the symbols and relocation have been removed by 
strip(]). 


In the header the sizes of each section are given in bytes. The size of the header is not 
included in any of the other sizes. 


When an a.out file is executed, three logical segments are set up: the text segment, the data 
segment (with uninitialized data, which starts off as all 0, following initialized), and a stack. 
The text segment begins at 0 in the core image; the header is not loaded. If the magic number 
in the header is OMAGIC (0407), it indicates that the text segment is not to be write-protected 
and shared, so the data segment is immediately contiguous with the text segment. This is the 
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oldest kind of executable program and is rarely used. If the magic number is NMAGIC (0410) 
or ZMAGIC (0413), the data segment begins at the first 0 mod 1024 byte boundary following 
the text segment, and the text segment is not writable by the program; if other processes are 
executing the same file, they will share the text segment. For ZMAGIC format, the text seg- 
ment begins at a 0 mod 1024 byte boundary in the a.owz file, the remaining bytes after the 
header in the first block are reserved and should be zero. In this case the text and data sizes 
must both be multiples of 1024 bytes, and the pages of the file will be brought into the running 
image as needed, and not pre-loaded as with the other formats. This is especially suitabie for 
very large programs and is the default format produced by /d(1). 


The stack will occupy the highest possible locations in the core image: growing downwards from 
Ox7ffff000. The stack is automatically extended as required. The data segment is only 
extended as requested by dreak(2). 


After the header in the file follow the text, data, text relocation data relocation, symbol table 
and string table in that order. The text begins at the byte 1024 in the file for ZMAGIC format 
or just after the header for the other formats. The N_TXTOFF macro returns this absolute file 
position when given the name of an exec structure as argument. The data segment is contigu- 
ous with the text and immediately followed by the text relocation and then the data relocation 
information. The symbol table follows all this: its position is computed by the N SYMOFF 
macro. Finally, the string table immediately follows the symbol! table at a position which can be 
gotten easily using N.STROFF. The first 4 bytes of the string table are not used for string 
storage, but rather contain the size of the string table, this size INCLUDES the 4 bytes, the 
minimum string table size is thus 4. 


The layout of a symbol table entry and the principal flag values that distinguish symbol types 
are given in the include file as follows: 


js 
« Format of a symbol table entry. 
«/ 
struct nlist { 
union { 
char en_ name; /* for use when in-core °/ 
iong n_strx; /* index into file string tabie «/ 
} n_un; 
unsigned char n_type, /® type flag, i.e. N_ TEXT etc; see below «/ 
char n_other; 
short n_desc, /* see <stab.h> */ 
unsigned n_value, /* value of this symbol (or sdb offset) +/ 
}; 
#define n_hash n_desc /* used internally by id «/ 
js 
e Simple values for n_type. 
of 
#define N_UNDF 0x0 /e undefined ¢/ 
#define N_ABS 0x2 /* absolute */ 


#define N_TEXT Ox4 /* text @/ 
#define N_DATA 0x6 /e data */ 


#define N_ BSS Ox8 /* bss °/ 

#define N.COMM 0x12 /* common (internal to Id) */ 
#define N_FN Oxif /* file name symbol °/ 
#define 01 /* external bit, or’ed in °/ 
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#define N_TYPE Oxle /* mask for all the type bits ¢/ 


fe 
e Other permanent symbol table entries have some of the N_STAB bits set. 
e These are given in <stab.h> 
o/ 

#define N_STAB Oxe0 /* if any of these bits set, don’t discard °/ 


fe 
* Format for namelist values. 
o/ 

#define N_FORMAT "%08x’ 


In the a.out file a symbol’s n_un.n_strx field gives an index into the string table. A n_strx 
value of 0 indicates that no name is associated with a particular symbol table entry. The field 
n_un.n_name can be used to refer to the symbol name only if the program sets this up using 
n_strx and appropriate data from the string table. 


If a symbol’s type is undefined external, and the value field is non-zero, the symbol is inter- 
preted by the loader /das the name of a common region whose size is indicated by the value of 
the symbol. 


The value of a byte in the text or data which is not a portion of a reference to an undefined 
external symbol is exactly that value which will appear in memory when the file is executed. If 
a byte in the text or data involves a reference to an undefined external symbol, as indicated by 
the relocation information, then the value stored in the file is an offset from the associated 
external symbol. When the file is processed by the link editor and the external symbol 
becomes defined, the value of the symbol will be added to the bytes in the file. 


If relocation information is present, it amounts to eight bytes per relocatable datum as in the 
following structure: 


Je 
« Format of a relocation datum. 
o/ 
struct relocation_info { 
int r_address, /* address which is relocated */ 
unsigned r_symboilnum:24, /« local symbol ordinal */ 
r_pcerel:1, /* was relocated pc relative already ¢/ 
r_length:2, /* 0=byte, 1=word, 2=long °/ 
r_extern:1, /e does not include value of sym referenced «/ 
"4: /e nothing, yet °/ 


There is no relocation information if a_trsize+a_drsize™=0. If r_extern is 0, then 


r_symboinum is actually a n_type for the relocation (i.e. N_TEXT meaning relative to segment 
text origin.) 


SEE ALSO 


BUGS 


adb(1), as(1), Id(1), nm(1), sdb(1), stab(5), strip(1) 


Not having the size of the string table in the header is a loss, but expanding the header size 
would have meant stripped executable file incompatibility, and we couidn’t hack this just now. 
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NAME 
acct — execution accounting file 


SYNOPSIS 
#include <sys/acct.h> 


DESCRIPTION 
Acct(2) causes entries to be made into an accounting file for each process that terminates. The 
accounting file is a sequence of entries whose layout, as defined by the include file is: 


/s acet i 3.2 6/6/80*/ 
/s 

« Accounting structures 

«/ 


typedef unsigned short comp_t; 
/* "floating pt": 3 bits base 8 exp, 13 bits fraction «/ 


struct acct { 
char ac.comm[l0]; /* Accounting command name =/ 


comp t ac_utime; /« Accounting user time */ 
comp _t ac_stime; /* Accounting system time «/ 
comp_t ac_etime; /« Accounting elapsed time +/ 
time_t ac_btime; /s Beginning time =/ 
short = ac_uid; /* Accounting user ID «/ 
short  ac_gid; /s Accounting group [D «/ 
short ac_mem; /* average memory usage */ 
comp _t ac_io; /* number of disk IO blocks «/ 
dev t ac tty; | /* control typewriter «/ 
char ac_flag; /* Accounting flag «/ 
I; 
extern struct acct acctbuf; 
extern struct inode eacctp;/* inode of accounting file «/ 
#define AFORK 01 /* has executed fork, but no exec «/ 
#defineASU 02 /* used super-user privileges */ 


If the process does an exec(2), the first 10 characters of the filename appear in ac_comm. The 
accounting flag contains bits indicating whether exec(2) was ever accomplished, and whether 
the process ever had super-user privileges. 


SEE ALSO 
acet(2), sa(1) 
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NAME 

aliases — aliases file for delivermail 
SYNOPSIS 

/usr/lib/aliases 
DESCRIPTION 


This file describes user id aliases that will be used by /erc/delivermail. It is formatted as a series 
of lines of the form 


name:addr! ,addr2,...addrn 
The name is the name to alias, and the addri are the addresses to send the message to. Lines 
beginning with white space are continuation lines. Lines beginning with ‘#’° are comments. 


Aliasing occurs only on local names. Loops can not occur, since no message will be sent to any 
person more than once. 


This is only the raw data file; the actual aliasing information is placed into a binary format in 
the files /usr/lib/aliases.dir and /usr/lib/aliases.pag using the program newaliases(5). A 
newaliases command should be executed each time the aliases file is changed for the change to 
take effect. 

SEEALSO) 
newaliases(1), dbm(3), delivermail (8) 

BUGS 
Because of restrictions in dbm(3) a single alias cannot contain more than about 1000 bytes of 


information. You can get longer aliases by ‘“‘chaining’’; i.e. make the last name in the alias by a 
dummy name which ts a continuation alias. 
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NAME 
ar — archive (library) file format 


SYNOPSIS 
#include <ar.h> 


DESCRIPTION 
N.B.: This archive format is new to this distribution. See ofd(8) and arcv(1) for programs to 
deal with the old format. 


The archive command ar ts used to combine several files into one. Archives are used mainly as 
libraries to be searched by the link-editor /d. | 


A file produced by ar has a magic string at the start. followed by the constituent files, each pre- 
ceded by a file header. The magic number and header layout as described in the include file 
are: 


#define ARMAG “!<arch>\n" 
#define SARMAG 8 


#define ARFMAG "‘\n" 


struct ar_hdr | 


char ar_name([16]; 
char ar _date[12]}, 

~ char ar_uid(6]; 
char ar _gid(6]; 
char ar_mode([8}; 
char ar_size{10]; 
char ar_fmag([2]; 


I; 
The name is a blank-padded string. The ar_fmag field contains ARFMAG to help verify the 
presence of a header. The other fields are left-adjusted, blank-padded numbers. They are 
decimal except for ar_mode, which 1s octal. The date is the modification date of the file at the 
time of its insertion into the archive. 


Each file begins on a even (0 mod 2) boundary; a new-line is inserted between files if neces- 
sary. Nevertheless the size given reflects the actual size of the file exclusive of padding. 
There is no provision for empty areas in an archive file. 


The encoding of the header is portable across machines. If an archive contains printable files, 
the archive itself is printable. 


SEE ALSO 
ar(1), 1Id(Q1), nm(1) 


BUGS 
File names lose trailing blanks. Most software dealing with archives takes even an included 
blank as a name terminator. 
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NAME 
core — format of memory image file 

DESCRIPTION 
UNIX writes out a memory image of a terminated process when any of various errors occur. 
See signal(2) for the list of reasons; the most common are memory violations, illegal instruc- 
tions, bus errors, and user-generated quit signals. The memory image is called ‘core’ and is 
written in the process’s working directory (provided it can be; normal access controls apply). 
The maximum size of a core file is limited by viimit(2). Files which would be larger than the 
limit are not created. 
The core file consists of the u. area, which currently consists of 6 pages, beginning with a user 
Structure as given in /usr/include/sys/user.h. The kernel stack grows from the end of this 6 
page region. The remainder of the core file consists first of the data pages and then the stack 
pages of the process image. | 
In general the debugger adb(1) is sufficient to deal with core images. 


SEE ALSO 
adb(1), signal(2), vlimit(2) 
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NAME 
dir — format of directories 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/dir.h> 


DESCRIPTION 
A directory behaves exactly like an ordinary file, save that no user may write into a directory. 
The fact that a file is a directory is indicated by a bit in the flag word of its i-node entry; see 
filsys(5). The structure of a directory entry as given in the include file is: 


#ifndef DIRSIZ 
#define DIRSIZ 14 
#endif 
Struct direct 
{ 
ino_t d_ ino; 
char d_ name[{DIRSIZ]; 
eB 
By convention, the first two entries in each directory are for ‘.’ and ‘..’. The first is an entry 
for the directory itself. The second is for the parent directory. The meaning of ‘..’ is modified 
for the root directory of the master file system (‘‘/’’), where ‘..’ has the same meaning as *.’. 


SEE ALSO 
filsys (5) 


t 


nn 
i 
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NAME 

dump, ddate — incremental dump format 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/ino.h> 

#include <dumprestor.h> 


DESCRIPTION 
Tapes used by dump and restor(1) contain: 
a header record 
two groups of bit map records 


a group of records describing directories 
a group of records describing files 


r’s Manual 
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The format of the header record and of the first record of each description as given in the 


include file < dumprestor.h> is: 


#define NITREC 10 
#define MLEN 16 
#define MSIZ 4096 


#define TS_TAPE ] 

#define TS INODE 2 

#define TS_BITS 3 

#define TS_ADDR 4 

#define TS END =‘ 59 

#define TS_CLRI 6 
#define MAGIC (int) 60011 
#define CHECKSUM (int) 84446 


struct spcl { 


int c_type; 

time_t c_date; 

time_t c_ddate; 

int c_volume; 
daddr_t c_tapea; 

ino_t c_inumber; 

int c_magic; 

int ¢_ checksum; 
Struct dinode c_dinode; 
int c_count; 

char c_addr[{BSIZE]; 


} spel; 


struct idates [{ 


char id name[16]; 
char id_incno; 
time_t _ id_ddate; 
E 
#define DUMPOUTFMT "%-16s Yor %s" 


#defineDUMPINFMT "%16s %c %["\n]\n" 


/* for printf */ 
/* name, incno, ctime(date) */ 
/« inverse for scanf «/ 
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NTREC is the number of 1024 byte records in a physical tape block. MLEN is the number of 
bits in a bit map word. MS/Z is the number of bit map words. 


The 7S_ entries are used in the c_type field to indicate what sort of header this is. The types 
and their meanings are as follows: 


TS TAPE 
TS_INODE 


TS_BITS 
TS_ADDR 
TS_END 
TS_CLRI 


MAGIC 


Tape volume label 

A file or directory follows. The c_dinode field is a copy of the disk inode and 
contains bits telling what sort of file this is. 

A bit map follows. This bit map has a one bit for each inode that was dumped. 

A subrecord of a file description. See c_addr below. 

End of tape record. 

A bit map follows. This bit map contains a zero bit for all inodes that were 
empty on the file system when dumped. 

All header records have this number in c_magic. 


CHECKSUM Header records checksum to this value. 
The fields of the header structure are as follows: 


c_type 
c_date 
c_ddate 
c_volume 
c_tapea 
c_inumber 
c_magic 

c_ checksum 
c_dinode 
c_count 
c_addr 


The type of the header. 

The date the dump was taken. 

The date the file system was dumped from. 

The current volume number of the dump. 

The current number of this (1024-byte) record. 

The number of the inode being dumped if this is of type TS_/NODE. 

This contains the value MAG/C above, truncated as needed. 

This contains whatever value is needed to make the record sum to CHECKSUM. 
This is a copy of the inode as it appears on the file system: see /lsys(5). 

The count of characters in c_addr. 

An array of characters describing the blocks of the dumped file. A character is 
zero if the block associated with that character was not present on the file sys- 
tem, otherwise the character is non-zero. If the block was not present on the file 
system, no block was dumped; the block will be restored as a hole in the file. If 
there is not sufficient space in this record to describe all of the blocks in a file, 
TS_ADDR records will be scattered through the file, each one picking up where 
the last left off. 


Each volume except the last ends with a tapemark (read as an end of file). The last volume 
ends with a TS_END record and then the tapemark. 


The structure idates describes an entry of the file /etc/ddate where dump history is kept. The 
fields of the structure are: 


id name 
id_incno 
id_ddate 


/etc/ddate 


SEE ALSO 
dump(8), dumpdir(8), restor(8), filsys(5), types (5) 


The dumped filesystem is ‘/dev/id_nam’. 
The level number of the dump tape; see dump(1). 
The date of the incremental dump in system format see types(5). 
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NAME 


environ — user environment 


SYNOPSIS 


extern char **environ; 


DESCRIPTION 


SEE AL 


An array of strings called the ‘environment’ is made available by exec(2) when a process 
begins. By convention these strings have the form ‘vame=value’. The following names are 
used by various commands: 


PATH The sequence of directory prefixes that sh, time, nice(1), etc., apply in searching for 
a file known by an incomplete path name. The prefixes are separated by ‘:’. 
Login(1) sets PATH =:/usr/ucb:/bin:/usr/bin. 


HOME A user’s login directory, set by /ogin(1) from the password file passwd(5). 

TERM The kind of terminal for which output is to be prepared. This information is used 
by commands, such as nroffor plot(1), which may exploit special terminal capabili- 
ties. See /etc/termcap (termcap(5)) for a list of terminal types. 

SHELL The file name of the users login shell. 


TERMCAP The string describing the terminal in TERM, or the name of the termcap file, see 
termcap(5) ,termlib(3). 


EXINIT A Startup list of commands read by ex(1), edit(1), and vi(1). 

USER The login name of the user. 

Further names may be placed in the environment by the export command and ‘name=value’ 
arguments in sh(1), or by the setenv command if you use csh(1). Arguments may also be 


placed in the environment at the point of an exec(2). It is unwise to conflict with certain sh(1) 
variables that are frequently exported by ‘.profile’ files: MAIL, PS1, PS2, IFS. 


SO 
esh(1), ex(1), login(1), sh(1), exec(2), system(3), termlib(3), termcap(5), term(7) 
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NAME 
filsys, flbik, ino — format of file system volume 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/fibk.h> 
#include <sys/filsys.h> 
#include <sys/ino.h> 


DESCRIPTION 
Every file system storage volume (e.g. RF disk, RK disk, RP disk, DECtape reel) has a com- 
mon format for certain vital information. Every such volume is divided into a certain number 
of 1024-byte blocks. Block 0 is unused and is available to contain a bootstrap program, pack 
label, or other information. 


Block 1 is the super block. The layout of the super block as defined by the include file 
< sys/filsys.A> is: 


/s filsys.h 3.2 6/6/80/ 

fe 

* Structure of the super-block 

«/ 

struct filsys { 
unsigned short s_isize; /* size in blocks of i-list */ 
daddr t s_fsize; /* size in blocks of entire volume «/ 
short s_nfree; /« number of addresses in s free */ 
daddr_t s free{NICFREE]; /s free block list «/ 
short  s_ninode; /* number of i-nodes in s_inode +/ 
ino_t s_inode[NICINOD]; /* free i-node list */ 
char §_flock; /* lock during free list manipulation «/ 
char S_ilock; /* lock during i-list manipulation */ 
char s_fmod; /* super block modified flag «/ 
char s_ronly; /* mounted read-only flag «/ 
time _t s_ time; /* last super block update «/ 
daddr t s_tfree; /+ total free blocks+/ 
ino t $s _tinode; /* total free inodes */ 
/* begin not maintained by this version of the system =/ 
short _s_dinfo[2}, /* interleave stuff =/ 

#define sm s_dinfo[0] 

#define sn s dinfo[1] 
char  s fnamel([6]; /* file system name */ 
char _—s_fpack(6]; /* file system pack name ¢/ 
/* end not maintained «/ 
ino. t = §_lasti; /* start place for circular search «/ 
ino_t $_nbehind; /= est # free inodes before s_lasti «/ 


iF 


#ifdef KERNEL 
struct filsys =getfsQ); 
#endif 


S_isize is the address of the first block after the i-list, which starts just after the super-block, in 
block 2. Thus the i-list is s_isize—2 blocks long. S_fsize is the address of the first block not 
potentially available for allocation to a file. These numbers are used by the system to check for 
bad block addresses; if an ‘impossible’ block address is allocated from the free list or is freed, a 


See ie okt 5-12 
4th Rerkelev Distribution 


FILSYS (5) UNIX Programmer’s Manual FILS Y5:45) 


diagnostic is written on the on-line console. Moreover, the free array is cleared, so as to 
prevent further allocation from a presumably corrupted free list. 


The free list for each volume is maintained as follows. The s_free array contains, in s_free[1/, 
.. , S_freels_nfree—1], up to NICFREE free block numbers. NICFREE is a configuration con- 
stant. S_free/0/ is the block address of the head of a chain of blocks constituting the free list. 
The layout of each block of the free chain as defined in the include file <sys/fblk.A> is: 


/* folk.h 3.2 6/6/80+/ 


struct folk { 

int df_nfree; 

daddr_t df_free[{NICFREE]; 
}; 


The fields df_nfree and df free in a free block are used exactly like s_nfree and s_free in the 
super block. To allocate a block: decrement s_afree, and the new block number is 
s_freels_nfree]. If the new block address is 0, there are no blocks left, so give an error. If 
s_nfree became 0, read the new block into s_nfree and s_free. To free a block, check if s_njfree is 
NICFREE; if so, copy s_nfree and the s_ free array into it, write it out, and set s nfree to 0. In 
any event set s_free/s_nfree/ to the freed block’s address and increment s_njree. 


S_ninode is the number of free i-numbers in the s_inode array. To allocate an i-node: if s_ninode 
is greater than 0, decrement it and return s_inode{s_ninode/. If it was 0, read the i-list and place 
the numbers of all free inodes (up to NICINOD) into the s_ inode array, then try again. To free 
an i-node, provided s_ninode is less than NICINODE, place its number into s_inode[s_ninode/ 
and increment s_ inode. If s_ninode is already NICINODE, don’t bother to enter the freed 1- 
node into any table. This list of i-nodes is only to speed up the allocation process; the informa- 
tion as to whether the inode ts really free or not is maintained in the inode itself. 


The fields s _/asti and s_nbehind are used to avoid searching the inode list from the beginning 
each time the system runs out of inodes. S /asti gives the base of the block of inodes last 
searched on the filesystem when inodes ran out, and s_nbehind gives the number of inodes, 
whose numbers were less than s_/asti when they were freed with s_ninode already NICINODE. 
Thus s_ninode is the number of free inodes before s_lasti. The system will search forward for 
free inodes from s_/asti for more inodes unless s_nbehind is sufficiently large, in which case it 
will search the file system inode list from the beginning. This mechanism serves to avoid n=#*2 
behavior in allocating inodes. 


S flock and s_ilock are flags maintained in the core copy of the file system while it is mounted 
and their values on disk are immaterial. The value of s_fmod on disk is likewise immaterial, it 
is used as a flag to indicate that the super-block has changed and should be copied to the disk 
during the next periodic update of file system information. S_ronly is a write-protection indica- 
tor; its disk value is also immaterial. 


S_time is the last time the super-block of the file system was changed. During a reboot, s_tme 
of the super-block for the root file system is used to set the system's idea of the time. 


The fields s_sfree, s_tinode, s_fname and s_fpack are not currently maintained. 


I-numbers begin at 1, and the storage for i-nodes begins in block 2. I-nodes are 64 bytes long, 
so 16 of them fit into a block. I-node 2 is reserved for the root directory of the file system, but 
no other i-number has a built-in meaning. Each i-node represents one file. The format of an 
i-node as given in the include file <sys/ino.hA> 1s: 


/s ino.h 83.2 6/6/80#/ 


/« 
« Inode structure as it appears on 
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* a disk block. 

«/ 

struct dinode { 
unsigned short di_mode;/« mode and type of file +/ 
short di_nlink; | /* number of links to file «/ 


short di_uid; /* owner’s user id +/ 
short di_gid; /* owner’s group id «/ 
off t  di_size; /* number of bytes in file «/ 


char  di_addr{40]; /* disk block addresses */ 
time_t di_atime; /* time last accessed */ 
time_t di_mtime; /* time last modified +/ 
time_t di_ctime; /»# time created «/ 


js 

« the 40 address bytes: 

we 39 used; 13 addresses 
® of 3 bytes each. 

a/ 


Di_mode tells the kind of file; it is encoded identically to the st_mode field of stat(2). Di_nlink is 
the number of directory entries (links) that refer to this i-node. Di_uid and di_gid are the 
owner's user and group [Ds. Size is the number of bytes in the file. Di_atime and di_mtime are 
the times of last access and modification of the file contents (read, write or create) (see 
times(2)); Di_ctime records the time of last modification to the inode or to the file, and is used 
to determine whether it should be dumped. . 


Special files are recognized by their modes and not by i-number. A block-type special file is 
one which can potentially be mounted as a file system; a character-type special file cannot, 
though it is not necessarily character-onented. For special files, the di_addr field is occupied by 
the device code (see types(5)). The device codes of block and character special files overlap. 


Disk addresses of plain files and directories are kept in the array di_addr packed into 3 bytes 
each. The first 10 addresses specify device blocks directly. The last 3 addresses are singly, 
doubly, and triply indirect and point to blocks of 256 block pointers. Pointers in indirect blocks 
have the type daddr_¢ (see rypes(5)). 


For block 61n a file to exist, it is not necessary that all blocks less than 5 exist. A zero block 
number either in the address words of the i-node or in an indirect block indicates that the 
corresponding block has never been allocated. Such a missing block reads as if it contained all 
zero words. 


SEE ALSO 
icheck (1), dcheck(1), dir(S), mount(1), stat(2), types(5) 
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NAME 
fstab — static information about the filesystems 


SYNOPSIS 
#include <fstab.h> 


DESCRIPTION 


The file /etc/fstab contains descriptive information about the various file systems. /etc/fstab is 


only read by programs, and not written; it is the duty of the system administrator to properly 
create and maintain this file. 


These programs use /etc/fstab: dump, mount, umount, swapon, fsck and df. The order of records in 


fetc/fstab is important, for both /Sck, mount, and umount sequentially iterate through /etc/fstab 
doing their thing. 


The special file name is the block special file name, and not the character special file name. Ifa 


program needs the character special file name, the program must create it by appending a ‘‘r”’ 
after the last ‘‘/°’ in the special file name. 


If /S_type is ‘‘rw”’ or ‘‘ro”’ then the file system whose name is given in the fs _file field is nor- 
mally mounted read-write or read-only on the specified special file. The /s_/req field is used for 
these file systems by the dump(8) command to determine which file systems need to be 
dumped. The /S_passno field is used by the /sck(8) program to determine the order in which 
file system checks are done at reboot time. The root file system should be specified with a 
fs_passno of 1, and other file systems should have larger numbers. File systems within a drive 
should have distinct numbers, but file systems on different drives can be checked on the same 
pass to utilize parallelism available in the hardware. 


If fs ope is ‘‘sw’’ then the special file is made avaiable as a piece of swap space by the 
swapon(8) command at the end of the system reboot procedure. The fields other than /s_spec 
and fs fpe are not used in this case. 


Fs _type may be specified as ‘‘xx’’ to cause an entry to be ignored. This is useful to show disk 
partitions which are currently not used but will be used later. 


#define FSTAB "/etc/fstab” 
#define FSNMLG 16 


#define FSTABFMT "% 1 65:% 1 65:%2s:%d:%d\n" 
#define FSTABARG(p) (p)—>fs_spec, (p)— >fs_file, \ 

(p) —>fs_type, &(p)—- >fs_freq, &(p) — >fs_passno 
#define FSTABNARGS 5 


#define FSTAB RW "rw" /* read write device */ 
#define FSTAB_RO "ro" /* read only device ¢/ 
#define FSTAB_SW "sw" /* swap device */ 
#define FSTAB_ XX "xx" /* ignore totally ¢/ 


struct fstab { 
char fs_spec(FSNMLG]; /* block special device name */ 
char fs file[FSNMLG); /e file system path prefix */ 


char fs_type(3]; /* rw,ro,sw or xx */ 
int fs freq; /* dump frequency, in days */ 
int fs_passno; /* pass number on parallel dump */ 
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The proper way to read records from /etc/siad is to use the routines getfsentQ, getfsspec() or 
getfsfile(). 


FILES 
/etc/fstab 


SEE ALSO 
getfsent (3) 
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NAME 
group — group file 

DESCRIPTION 
Group contains for each group the following information: 
group name 
encrypted password 
numerical group ID 
a comma separated list of all users allowed in the group 


od 


This is an ASCII file. The fields are separated by colons; Each group is separated from the next 
by anew-line. If the password field is null, no password is demanded. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have 
general read permission and can be used, for example, to map numerical group [D’s to names. 
FILES 
/etc/group 
SEE ALSO 
newerp(1), crypt(3), passwd(1), passwd(5) 
BUGS 
The passwd(1) command won’t change the passwords. 
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NAME 
mpxio — multiplexed i/o 


SYNOPSIS 
#tinclude <sys/mx.h> 


#include <sgtty.h> 


DESCRIPTION oye | 
Data transfers on mpx files (see mpx(2)) are multiplexed by imposing a record structure on 
the io stream. Each record represents data from/to a particular channel or a control or status 
message associated with a particular channel. 


The prototypical data record read from an mpx file is as follows 


struct input_record | 
short index; 
short count; 
short ccount; 
char __ data{]; 
h; 
where index identifies the channel, and count specifies the number of characters in data. If count 
is zero, ccount gives the size of daa, and the record is a control or status message. Although 
count or ccount might be odd, the operating system aligns records on short (i.e. 16—bit) boun- 
daries by skipping bytes when necessary. 


Data written to an mpx file must be formatted as an array of record structures defined as fol- 
lows 


struct output_record | 
short index: 
short count; 
short ccount; 
char «data; 
i 
where the data portion of the record is referred to indirectly and the other cells have the same 
interpretation as in input_record. 


The control messages listed below may be read from a multiplexed file descriptor. They are 
presented as two 16-bit integers: the first mumber is the message code (defined in 
< sys/mx.h>), the second is an optional parameter meaningful only with M_WATCH, M_BLK, 
and M_ SiG. 


M_WATCH a process ‘wants to attach” on this channel. The second parameter is the 16-bit 
user-id of the process that executed the open. 


M_CLOSE the channel is closed. This message is generated when the last file descriptor 
referencing a channel is closed. The detach command (see »ipx(2) should be used 
in response to this message. 


M_EOT indicates logical end of file on a channel. If the channel is joined to a typewriter, 
EOT (control-d) will cause the M_EOT message under the conditions specified in 
ity(4) for end of file. If the channel is attached to a process, M_EOT will be gen- 
erated whenever the process writes zero bytes on the channel. 


M_BLK if non-blocking mode has been enabled on an mpx file descriptor xd by executing 
ioctl(xd, MXNBLK, 0), write operations on the file are truncated in the kernel 
when internal queues become full. This is done on a per-channel basis: the 
parameter is a count of the number of characters not transferred to the channel 
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on which M_BLK is received. 


M_UBLK is generated for a channel after M_BLK when the internal queues have drained 
below a threshold. 


M_SIG is generated instead of a normal asynchronous signal on channels that are joined 
to typewriters. The parameter is the signal number. 


Two other messages may be generated by the kernel.’ As with other messages, the first 16-bit 
quantity is the message code. 


M_OPEN is generated in conjunction with ‘listener’ mode (see mpx(2)). The uid of the cal- 
ling process follows the message code as with M_WATCH. This is followed by a 
null-terminated string which is the name of the file being opened. 


M_IOCTL is generated for a channel connected to a process when that process executes the 
ioctl(fd, cmd, &vec) call on the channel file descriptor. The M_IOCTL code is fol- 
lowed by the cmd argument given to joct/ followed by the contents of the structure 
vec. It is assumed, not needing a better compromise at this time, that the length of 
vec is determined by sizeof (struct sgttyb) as declared in <sgfty.h>. 


Two control messages are understood by the operating system. M_EOT may be sent through 
an mpx file to a channel. It is equivalent to propagating a zero-length record through the chan- 
nel: i.e. the channel is allowed to drain and the process or device at the other end receives a 
zero-length transfer before data starts flowing through the channel again. M_IOANS can also 
be sent through a channel to reply to a M_IOCTL. The format is identical to that received 
from M_IOCTL. 


SEE ALSO 
mpx(2) 
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NAME 
mtab — mounted file system tabie 


DESCRIPTION 
Mtab resides in directory /etc and contains a table of devices mounted by the mount command. 
Umount removes entries. 


Each entry is 64 bytes long; the first 32 are the null-padded name of the place where the special 
file is mounted; the second 32 are the null-padded name of the special file. The special file has 
all its directories stripped away, that is, everything through the last ‘/° is thrown away. 


This table is present only so people can look at it. [It does not matter to mount if there are 
duplicated entries nor to wmount if a name cannot be found. 


FILES — 
/etc/mtab 


SEE ALSO 
mount(8) 
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NAME 
passwd — password file 


DESCRIPTION 
Passwd contains for each user the following information: 


name (login name, contains no upper case) 
encrypted password 

numerical user ID 

numerical group ID 

user’s real name, office, extension, home phone. 
initial working directory 

program to use as Shell 


The name may contain ‘&’, meaning insert the login name. This information is set by the 
chfn(1) command and used by the finger(1) command. 


This is an ASCII file. Each field within each user’s entry is separated from the next by a colon. 
Each user is separated from the next by a new-line. If the password field is null, no password is 
demanded; if the Shell field is null, then /bin/sh is used. 


This file resides in directory /etc. Because of the encrypted passwords, it can and does have 
general read permission and can be used, for example, to map numerical user [D’s to names. 


Appropriate precautions must be taken to lock the file against changes if it is to be edited with a 

text editor; vipw(8) does the necessary locking. 
FILES | 

/etc/passwd 
SEE ALSO 

getpwent(3), login(1), crypt(3), passwd(1), group(5), chfn(1), finger(1), vipw(8), adduser(8) 
BUGS . 
: A binary indexed file format should be available for fast access. 
User information (name, office, etc.) should be stored elsewhere. 
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plot — graphics interface 


DESCRIPTION 
Files of this format are produced by routines described in plor(3), and are interpreted for vari- 
ous devices by commands described in ploz(1). A graphics file is a stream of plotting instruc- 
tions. Each instruction consists of an ASCII letter usually followed by bytes of binary informa- 
tion. The instructions are executed in order. A point is designated by four bytes representing 
the x and y values; each value is a signed integer. The last designated point in an 1, m, n, or p 
instruction becomes the ‘current point’ for the next instruction. 


Each of the following descriptions begins with the name of the corresponding routine in ploz(3). 


mi 


n 


SEE ALSO 


move: The next four bytes give a new current point. 


cont: Draw a line from the current point to the point given by the next four bytes. See 
plor(1). 


point: Plot the point given by the next four bytes. | 


line: Draw a line from the point given by the next four bytes to the point given by the fol- 
lowing four bytes. 


label: Place the following ASCII string so that its first character falls on the current point. 
The string is terminated by a newline. 


arc: The first four bytes give the center, the next four give the starting point, and the last 
four give the end point of a circular arc. The least significant coordinate of the end point is 
used only to determine the quadrant. The arc is drawn counter-clockwise. 


circle: The first four bytes give the center of the circle, the next two the radius. 
erase: Start another frame of output. 


linemod: Take the following string, up to a newline, as the style for drawing further lines. 
The styles are ‘dotted,’ ‘solid,’ ‘longdashed,’ ‘shortdashed,’ and ‘dotdashed.’ Effective only 
in plot 4014 and plot ver. 


space: The next four bytes give the lower left corner of the plotting area; the following four 
give the upper right corner. The plot will be magnified or reduced to fit the device as 
closely as possible. 

Space settings that exactly fill the plotting area with unity scaling appear below for devices 
Supported by the filters of plor(1). The upper limit is just outside the plotting area. In 
every case the plotting area is taken to be square; points outside may be displayable on dev- 
ices whose face isn’t square. 


4014 space(0, 0, 3120, 3120); 


ver space(0, 0, 2048, 2048); 
300, 300s space(0, 0, 4096, 4096); 
450 space(0, 0, 4096, 4096); 


plot(1), plot(3), graph(1) 
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NAME 


stab — symbol table types 


SYNOPSIS 


#include <stab.h> 


DESCRIPTION 


Stab.h defines some values of the n_type field of the symbol table of a.out files. These are the 
types for permanent symbols (i.e. not local labels, etc.) used by the debugger sdb(1) and the 
Berkeley Pascal compiler pc(1). Symbol table entries can be produced by the .stabs assembler 
directive. This allows one to specify a double-quote delimited name, a symbol type, one char 
and one short of information about the symbol, and an unsigned long (usually an address). To 
avoid having to produce an explicit label for the address field, the .stabd directive can be used 
to implicitly address the current location. If no name is needed, symbol table entries can be 
generated using the .stabn directive. The loader promises to preserve the order of symbol table 
entries produced by .stab directives. As described in a.out(5), an element of the symbol table 
consists of the following structure: 


/« 
* Format of a symbol table entry. 
a/ 
struct nlist { 
union { 
char *n_name; /* for use when in-core */ 
long n_strx; /# index into file string table +/ 
} nun; 
unsigned char n_type, /* type flag +/ 
char n_other; /* unused */ 
short n_desc; /*# see struct desc, below */ 
unsigned n_value; /* address or offset or line */ 


ie 
The low bits of the n_type field are used to place a symbol into at most one segment, according 


to the following masks, defined in <a.out.h>. A symbol can be in none of these segments by 
having none of these segment bits set. 


/s 

« Simple values for n_type. 

«/ 
#define N.UNDF 0x0 /* undefined «/ 
#define N_ABS Ox2 /* absolute «/ 
#define N_TEXT 0x4 /# text / 
#define N DATA 0x6 /« data */ 
#define N_BSS Ox§ /* bss */ 


#define NEXT 1 /* external bit, or’ed in */ 


The n_value field of a symbol is relocated by the linker, /d(5) as an address within the appropri- 
ate segment. N_value fields of symbols not in any segment are unchanged by the linker. In 
addition, the linker will discard certain symbols, according to rules of its own, unless the n_type 
field has one of the following bits set: 
Js 

* Other permanent symbol table entries have some of the N_STAB bits set. 

« These are given in <stab.h> 

«/ 
#define N_STAB Oxe0/* if any of these bits set, don’t discard */ 
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This allows up to 112 (7 «© 16) symbol types, split between the various segments. Some of 
these have already been claimed. The symbolic debugger, sdb(1), uses the following n_type 
values: 


#define N.GSYM 0x20 /= global symbol: name,,0,type,0 */ 

#define N_FNAME 0x22 /* procedure name (f77 kludge): name,,0 #/ 
#define N_FUN Ox24 /* procedure: name,,0,linenumber,address «/ 
#define N'STSYM 0x26 /« static symbol: name,,0,type.address */ 
#define N_LCSYM 0x28 /* .icomm symbol: name,,0,type,address «/ 
#define N_ RSYM 0x40 /= register sym: name,,0,type,register */ 
#define N SLINE 0x44 /* src line: 0,,0,linenumber,address */ 

#define N'SSSYM 0x60 /* structure-elt: name,,0,type,struct_offset =/ 
#define N_SO 0x64 /* source file name: name,,0,0,address «/ 
#define N_LSYM 0x80 /«# local sym: name,,0,type,offset «/ 

#define N_SOL 0x84 /* #included file name: name,,0,0,address */ 
#define N_PSYM Oxa0 /*# parameter: name,,0,type,offset +/ 

#define NLENTRY 0Oxa4 /s alternate entry: name,linenumber,address «/ 
#define N_LBRAC OxcO /* left bracket: 0,,0,nesting level,address «/ 
#define N_RBRAC OxeO /* right bracket: 0,,0,nesting level,address +/ 
#define N_BCOMM Oxe2 /* begin common: name,, «/ 

#define N_ECOMM Oxe4 /* end common: name,, «/ 

#define N_ECOML Oxe8 /* end common (local name): .,address +/ 
#define N LENG Oxfe /* second stab entry with length information =/ 


where the comments give the sdb conventional use for .stads and the n_name, n_other, n_desc, 
and n_value fields of the given n_type. Sdb uses the n_desc field to hold a type specifier in the 
form used by the Portable C Compiler, cc(1), in which a base type is qualified in the following 
structure: | 


struct desc { 

short 6:2, 
q5:2, 
a4:2, 
qo: 
q2:2, 
qi:2; 
basic:4: 


a 


There are four qualifications, with qi the most significant and q6 the least significant: 


0 none 
l pointer 
Z function 
3 array 
The sixteen basic types are assigned as follows: 
0 undefined 
l function argument 
2 character 
3 short 
4 int 
5 long 
6 float 
7 double 
& structure 
9 union 
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10 enumeration 

1] member of enumeration 
12 unsigned character 

13 unsigned short 

14 unsigned int 

15 unsigned long 


The Berkeley Pascal compiler, pc(1), uses the following n_type value: 
#defineN PC 0x30 /* global pascal symbol: name,,0,subtype,line »/ 


and uses the following subtypes to do type checking across separately compiled files: 
source file name 
included file name 
global label 
global constant 
global type 
global variable 
global function 
global procedure 
external function 
0 external procedure 


ms (9 CO~) CVA A bm Go RO 


SEE ALSO 
_ as(1), Id(1), sdb(1), a-out(S) 


BUGS 
Sdb(1) assumes that a symbol of type N_GSYM with name name is located at address _ name. 
More basic types are needed. 
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NAME 
termcap — terminal capability data base 
SYNOPSIS 
/etc/termcap 
~ DESCRIPTION 


Termcap is a data base describing terminals, used, e.g., by w(1) and curses(3). Terminals are 
described in termcap by giving a set of capabilities which they have, and by describing how 
operations are performed. Padding requirernents and initialization sequences are included in 
termcap. 


Entries in termcap consist of a number of *:’ separated fields. The first entry for each terminal 
gives the names which are known for the terminal, separated by ‘? characters. The first name is 
always 2 characters long and is used by older version 6 systems which store the terminal type in 
a 16 bit word in a systemwide data base. The second name given is the most common abbrevi- 
ation for the terminal, and the last name given should be a long name fully identifying the ter- 
minal. The second name should contain no blanks; the last name may well contain blanks for 
readability. 


CAPABILITIES 
(P) indicates padding may be specified 
(P*) indicates that padding may be based on no. lines affected 


Name Type Pad? Description 


ae str (P) End alternate character set 

al str (P*) Add new biank line 

am bool Terminal has automatic margins 

as str (P) Start alternate character set 

be str 3 Backspace if not “H 

bs bool Terminal can backspace with “H 

bt str (P) Back tab 

bw bool Backspace wraps from column 0 to last column 

CC str Command character in prototype if terminal settabie 
cd str (Pe) Clear to end of display 

ce str (P) Clear to end of line 

ch str (P) Like cm but horizontal motion only, line stays same 
cl str (P+) Clear screen 

em str (P) Cursor motion 

co num Number of columns in a line 

er str (P*) Carriage return, (default “M) 


cs str (P) Change scrolling region (vt100), like cm 
eV str (P) Like ch but vertical only. 


da bool Display may be retained above 

dB num Number of millisec of bs delay needed 
db bool Display may be retained below 

dC num Number of millisec of cr delay needed 
de str (P*) Delete character 

dF num Number of millisec of f delay needed 
di str (P*) Delete line 

dm str Delete mode (enter) 

dN num Number of millisec of ni delay needed 
do str Down one line 

dT num Number of millisec of tab delay needed 
ed str End delete mode 
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el str 

eo str 

ff str (Pe) 
he bool 

hd str 

ho str 

hu str 

hz str 

ic str  (P) 
if str 

im bool 

in bool 

ip str (Ps) 
is str 
k0-k9 str 

kb str 

kd str 

ke str 

kh str 

kl str 

kn num 
ko str 

kr str 

KS str 

ku str 
10-19 str 

li num 

ll Str 

ma str 

mi bool 
mil str 

mu _— str 

nc bool 

nd str 

nl str (Pe) 
ns bool 

OS bool 
pe sir 

pt bool 

se str 

sf str (P) 
Sg num 
SO str 


sr str (P) 
ta str  (P) 


tc str 
te str 
ti str 
uc str 
ue Str 
ug num 
ul bool 


4th Berkeley Distribution 


UNIX Programmer’s Manual 


End insert mode; give ‘‘:ei=:”° if ic 

Can erase overstrikes with a blank 
Hardcopy terminal page eject (default *L) 
Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 
Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 
Hazeltine; can’t print ~’s 

Insert character 

Name of file containing is 

Insert mode (enter); give ‘‘:im=:”’ if ic 
Insert mode distinguishes nulls on display 
Insert pad after character inserted 
Terminal initialization string 

Sent by “‘other’’ function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of ‘“‘keypad transmit’? mode 

Sent by home key 

Sent by terminal left arrow key 

Number of ‘other’ keys 

Termcap entries for other non-function keys 
Sent by terminal right arrow key 

Put terminal in ‘“‘keypad transmit’? mode 
Sent by terminal up arrow key 
Labels on ‘‘other’’ function keys 
Number of lines on screen or page 

Last line, first column (if no em) 

Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Memory unlock (turn off memory lock). 
No correctly working carriage return (DM2500,H2000) 
Non-destructive space (cursor right) 
Newline character (default \n) 

Terminal is a CRT but doesn’t scroll. 
Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 
End stand out mode 

Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 

Scroll reverse (backwards) 

Tab (other than “I or with padding) 
Entry of similar terminal - must be last 
String to end programs that use cm 

String to begin programs that use cm 
Underscore one char and move past it 
End underscore mode 

Number of blank chars left by us or ue 
Terminal underlines even though it doesn’t overstrike 
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up str Upline (cursor up) 

us str Start underscore mode 

vb str Visible bell (may not move cursor) 

ve Str Sequence to end open/visual mode 

vs str Sequence to start open/visual mode 

xb bool Beehive (f1 escape, f2=ctrl C) 

xn bool A newline is ignored after a wrap (Concept) 

XP bool Return acts like ce \r \n (Delta Data) 

XS bool Standout not erased by writing over it (HP 2647) 
xt bool Tabs are destructive, magic so char (Teleray 1061) 


A Sample Entry 


The following entry, which describes the Concept~—100, is among the more complex entries in 
the termcap file as of this writing. (This particular concept entry is outdated, and is used as an 
example only.) 


c1|c100|concept100:is =\EU\EfN\ E7\ES5\E8\ EN ENH\EK\E\200\Eo&\200:\ 
cal == 3*\E°R:am:bs:cd = 16*\E°C:ce = 16\E°S:cl = 2*°L:cm=\Ea%+ %+ :co##80:\ 
:de= 16\E° A:dl=3+\E*B:ei =\E\200:e0:im =\EP:in:ip = 16«:1i#24:mi:nd=\E=:\ 
‘se =\Ed\Ee:so=\ED\EE:ta= 8\t:ul:up=\E;:vb =\EK\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last character of a line, and that 
empty fields may be included for readability (here between the last field on a line and the first 
field on the next). Capabilities in termicap are of three types: Boolean capabilities which indicate 
that the terminal has some particular feature, numeric capabilities giving the size of the termi- 
nal or the size of particular delays, and string capabilities, which give a sequence which can be 
used to perform particular terminal operations. 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the Concept has ‘‘automatic 
margins” (i.e. an automatic return and linefeed when the end of a line is reached) is indicated 
by the capability am. Hence the description of the Concept includes am. Numeric capabilities 
are followed by the character ‘#° and then the value. Thus co which indicates the number of 
columns the terminal has gives the value ‘80’ for the Concept. 

Finally, string valued capabilities, such as ce (clear to end of line sequence) are given by the 
two character code, an ‘=’, and then a String ending at the next following ‘:’. A delay in mil- 
liseconds may appear after the ‘=° in such a capability, and padding characters are supplied by 
the editor after the remainder of the string is sent to provide this delay. The delay can be 
either a integer, e.g. ‘20’, or an integer followed by an ‘»’, Le. ‘3*’. A ‘#’ indicates that the 
padding required is proportional to the number of lines affected by the operation, and the 
amount given is the per-affected-unit padding required. When a ‘*’ is specified, it is sometimes 


useful to give a delay of the form °3.5’ specify a delay per unit to tenths of milliseconds. 


A number of escape sequences are provided in the string valued capabilities for easy encoding 
of characters there. A \E maps to an ESCAPE character, “x maps to a control-x for any 
appropriate x, and the sequences \n \r \t \b \f give a newline, return, tab, backspace and 
formfeed. Finally, characters may be given as three octal digits after a \, and the characters * 
and \ may be given as \* and \\. If it is necessary to place a : in a capability it must be escaped 
in octal as \072. If it is necessary to place a null character in a string capability it must be 
encoded as \200. The routines which deal with termcap use C strings, and strip the high bits of 
the output very late so that a \200 comes out as a \000 would. 
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Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most effective way to prepare a 
terminal description is by imitating the description of a similar terminal in termcap and to build 
up a description gradually, using partial descriptions with ex to check that they are correct. Be 
aware that a very unusual terminal may expose deficiencies in the ability of the termcap file to 
describe it or bugs in ex. To easily test a new terminal description you can set the environment 
variable TERMCAP to a pathname of a file containing the description you are working on and 
the editor will look there rather than in /etc/termcap. TERMCAP can also be set to the termcap 


entry itself to avoid reading the file when starting up the editor. (This only works on version 7 
systems.) 


Basic capabilities 


The number of columns on each line for the terminal ts given by the co numeric capability. If 
the terminal is a CRT, then the number of lines on the screen is given by the li capability. If 
the terminal wraps around to the beginning of the next line when it reaches the right margin, 
then it should have the am capability. If the terminal can clear its screen, then this is given by 
the cl string capability. If the terminal can backspace, then it should have the bs capability, 
unless a backspace is accomplished by a character other than “H (ugh) in which case you 
should give this character as the be string capability. If it overstrikes (rather than clearing a 
position when a character is struck over) then it should have the os capability. 


A very important point here is that the local cursor motions encoded in termcap are undefined 
at the left and top edges of a CRT terminal. The editor will never attempt to backspace around 
the left edge, nor will it attempt to go up locally off the top. The editor assumes that feeding 
off the bottom of the screen will cause the screen to scroll up, and the am capability tells 
whether the cursor sticks at the right edge of the screen. If the terminal has switch selectable 
automatic margins, the termicap file usually assumes that this is on, i.e. am. 


These capabilities suffice to describe hardcopy and ‘‘glass-tty’’ terminals. Thus the model 33 
teletype is described as 


t3133|tty33:co#72:0s 
while the Lear Siegler ADM-—3 is described as 
clladm33lsi adm3:am:bs:cl =*Z:li#24:co#80 
Cursor addressing 


Cursor addressing in the terminal is described by a cm string capability, with print/(3s) like 
escapes %x in it. These substitute to encodings of the current line or column position, while 
other characters are passed through unchanged. If the em string is thought of as being a func- 
tion, then its arguments are the line and then the column to which motion is desired, and the 
% encodings have the following meanings: 


Yd as in privtf, 0 origin 

%2 like %2d 

%3 like %3d 

%, like %c 

%+x adds x to value, then %. 

%>xy if value > x adds y, no output. 

Yr reverses order of line and column, no output 

%i increments line/column (for 1 origin) 

%% gives a single % 

Yn exclusive or row and column with 0140 (DM2500) 
%B BCD (16+*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 
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Consider the HP2645, which, to get to row 3 and column 12, needs to be sent \E&al2c03Y 
padded for 6 milliseconds. Note that the order of the rows and columns is inverted here, and 
that the row and column are printed as two digits. Thus its em capability is 
“om = 6\EX%r%2c%2Y"’. The Microterm ACT-IV needs the current row and column sent pre- 
ceded by a “T, with the row and column simply encoded in binary, ‘‘cm=“T%.%.’’. Terminals 
which use ‘*%.’’ need to be able to backspace the cursor (bs or be), and to move the cursor up 
one line on the screen (up introduced below). This is necessary because it is not always safe to 
transmit \t, \n “D and \r, as the system may change or discard them. 


A final example is the LSI ADM-3a, which uses row and column offset by a blank character, thus 
‘“‘om=\E=% + %+ °’, 


Cursor motions 


if the terminal can move the cursor one position to the right, leaving the character at the 
current position unchanged, then this sequence shouid be given as nd (non-destructive space). 
If it can move the cursor up a line on the screen in the same column, this should be given as 
up. If the terminal has no cursor addressing capability, but can home the cursor (to very upper 
left corner of screen) then this can be given as ho; similarly a fast way of getting to the lower 
left hand corner can be given as I]; this may involve going up with up from the home position, 
but the editor will never do this itself (unless Il does) because it makes no assumption about 
the effect of moving up from the home position. 


Area clears 


If the terminal can clear from the current position to the end of the line, leaving the cursor 
where it is, this should be given as ce. If the terminal can clear from the current position to 
the end of the display, then this should be given as cd. The editor only uses ed from the first 
column of a line. 


Insert/delete line 


If the terminal can open a new biank line before the line where the cursor is, this should be 
given as al; this is done only from the first position of a line. The cursor must then appear on 
the newly blank line. If the terminal can delete the line which the cursor is on, then this 
should be given as dl; this is done only from the first position on the line to be deleted. If the 
terminal can scroll the screen backwards, then this can be given as sb, but just al suffices. If 
the terminal can retain display memory above then the da capability should be given; if display 
memory can be retained below then db should be given. These let the editor understand that 
deleting a line on the screen may bring non-blank lines up from below or that scrolling back 
with sb may bring down non-blank lines. 


Insert/delete character 


There are two basic kinds of intelligent terminals with respect to insert/delete character which 
can be described using ‘ermicap. The most common insert/delete character operations affect only 
the characters on the current line and shift characters off the end of the line rigidly. Other ter- 
minals, such as the Concept 100 and the Perkin Eimer Owl, make a distinction between typed 
and untyped blanks on the screen, shifting upon an insert or delete only to an untyped blank on 
the screen which is either eliminated, or expanded to two untyped blanks. You can find out 
which kind of terminal you have by clearing the screen and then typing text separated by cursor 
motions. Type.‘tabe def’ using local cursor motions (not spaces) between the ‘‘abc’’ and the 
‘def’. Then position the cursor before the ‘‘abc’’ and put the terminal in insert mode. If typ- 
ing characters causes the rest of the line to shift rigidly and characters to fall off the end, then 
your terminal does not distinguish between blanks and untyped positions. If the ‘‘abc’’ shifts 
over to the “‘def’ which then move together around the end of the current line and onto the 
next as you insert, you have the second type of terminal, and should give the capability in, 
which stands for “insert null’’. If your terminal does something different and unusual then you 
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may have to modify the editor to get it to use the insert mode your terminal defines. We have 
seen no terminals which have an insert mode not not falling into one of these two classes. 


The editor can handle both terminals which have an insert mode, and terminals which send a 
simple sequence to open a blank position on the current line. Give as im the sequence to get 
into insert mode, or give it an empty value if your terminal uses a sequence to insert a blank 
position. Give as ei the sequence to leave insert mode (give this, with an empty value also if 
you gave im so). Now give as ic any sequence needed to be sent just before sending the char- 
acter to be inserted. Most terminals with a true insert mode will not give ic, terminals which 
send a sequence to open a screen position should give it here. (Insert mode ts preferable to the 
sequence to open a position on the screen if your terminal has both.) If post insert padding is 
needed, give this as a number of milliseconds in ip (a string option). Any other sequence 
which may need to be sent after an insert of a single character may also be given in ip. 


It is occasionally necessary to move around while in insert mode to delete characters on the 
same line (e.g. if there is a tab after the insertion position). If your terminal allows motion 
while in insert mode you can give the capability mi to speed up inserting in this case. Omitting 


mi will affect only speed. Some terminals (notably Datamedia’s) must not have mi because of 
the way their insert mode works. 


Finally, you can specify delete mode by giving dm and ed to enter and exit delete mode, and de 
to delete a single character while in delete mode. 


Highlighting, underlining, and visible bells 


If your terminal has sequences to enter and exit standout mode these can be given as so and se 
respectively. If there are several flavors of standout mode (such as inverse video, blinking, or 
underlining — half bright is not usually an acceptable ‘‘standout’’ mode unless the terminal is 
in inverse video mode constantly) the preferred mode is inverse video by itself. If the code to 
change into or out of standout mode leaves one or even two blank spaces on the screen, as the 


TVI 912 and Teleray 1061 do, this is acceptable, and although it may confuse some programs 
slightly, it can’t be helped. 


Codes to begin underlining and end underlining can be given as us and ue respectively. If the 
terminal has a code to underline the current character and move the cursor one space to the 
right, such as the Microterm Mime, this can be given as uc. (If the underline code does not 
move the cursor to the right, give the code followed by a nondestructive space.) 


If the terminal has a way of flashing the screen to indicate an error quietly (a bell replacement) 
then this can be given as vb; it must not move the cursor. If the terminal should be placed in a 
different mode during open and visual modes of ex, this can be given as vs and ve, sent at the 
start and end of these modes respectively. These can be used to change, e.g., from a underline 
to a block cursor and back. 


If the terminal needs to be in a special mode when running a program that addresses the cur- 
sor, the codes to enter and exit this mode can be given as ti and te. This arises, for example, 
from terminals like the Concept with more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative cursor addressing, a one screen-sized 
window must be fixed into the terminal for cursor addressing to work properly. 


If your terminal correctly generates underlined characters (with no special codes needed) even 
though it does not overstrike, then you should give the capability ul. If overstrikes are erasabie 
with a blank, then this should be indicated by giving eo. 


Keypad 


If the terminal has a keypad that transmits codes when the keys are pressed, this information 
can be given. Note that it is not possible to handle terminals where the keypad only works in 
local (this applies, for example, to the unshifted HP 2621 keys). If the keypad can be set to 
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transmit or not transmit, give these codes as ks and ke. Otherwise the keypad is assumed to 
always transmit. The codes sent by the left arrow, right arrow, up arrow, down arrow, and 
home keys can be given as kl, kr, ku, kd, and kh respectively. If there are function keys such 
as f0, fl, ..., £9, the codes they send can be given as k0, kl, ..., k9. If these keys have labels 
other than the default f0 through f9, the labels can be given as 10, 11, ..., 19. If there are other 
keys that transmit the same code as the terminal expects for the corresponding function, such 
as clear screen, the termcap 2 letter codes can be.given in the ko capability, for example, 
**:ko==cl Il ,sf,sb:’*, which says that the terminal has clear, home down, scroll down, and scroll 
up keys that transmit the same thing as the cl, Il, sf, and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which have single character arrow 
keys. It is obsolete but still in use in version 2 of vi, which must be run on some minicomput- 
ers due to memory limitations. This field is redundant with kl, kr, ku, kd, and kh. It consists 
of groups of two characters. In each group, the first character is what an arrow key sends, the 
second character is the corresponding vi command. These commands are h for kl, j for kd, k 
for ku, | for kr, and H for kh. For example, the mime would be :ma=*Kj*Zk“X1: indicating 
arrow keys left (“H), down (“K), up (°Z), and right (“X). (There is no home key on the 
mime.) | 


Miscellaneous 
If the terminal requires other than a null (zero) character as a pad, then this can be given as pc. 


If tabs on the terminal require padding, or if the terminal uses a character other than “I to tab, 
then this can be given as ta. 


69 


Hazeltine terminals, which don’t allow characters to be printed should indicate hz. 
Datamedia terminals, which echo carriage-return linefeed for carriage return and then ignore a 
following linefeed should indicate ne. Early Concept terminals, which ignore a linefeed 
immediately after an am wrap, should indicate xn. If an erase-eol is required to get rid of stan- 
dout (instead of merely writing on top of it), xs should be given. Teleray terminals, where tabs 
turn all characters moved over to blanks, should indicate xt. Other specific terminal problems 
may be corrected by adding more capabilities of the form xx. 


Other capabilities include is, an initialization string for the terminal, and if, the name of a file 
containing long initialization strings. These strings are expected to properly clear and then set 
the tabs on the terminal, if the terminal has settable tabs. If both are given, is will be printed 
before if. This is useful where if is /usr/lib/tabset/std but is clears the tabs first. 


Similar Terminals 


If there are two very similar terminals, one can be defined as being just like the other with cer- 
tain exceptions. The string capability te can be given with the name of the similar terminal. 
This capability must be /as¢ and the combined length of the two entries must not exceed 1024. 
Since term/ib routines search the entry from left to right, and since the tc capability is replaced 
by the corresponding entry, the capabilities given at the left override the ones in the similar ter- 
minal. A capability can be cancelled with xx@ where xx is the capability. For example, the 
entry 


hn|2621nl:ks@ :ke@:tc=2621: 


defines a 262Inl that does not have the ks or ke capabilities, and hence does not turn on the 
function key labels when in visual mode. This is useful for different modes for a terminal, or 
for different user preferences. 


FILES 
/etc/termcap _ file containing terminal descriptions 
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SEE ALSO 

ex(1), curses(3), termcap(3), tset(1), vi(1), ul(1), more(1) 
AUTHOR 

William Joy 

Mark Horton added underlining and keypad support 
BUGS uf 


Ex allows only 256 characters for string capabilities, and the routines in termcap(3) do not check 
for overflow of this buffer. The total length of a single entry (excluding only escaped newlines) 
may not exceed 1024. 


The ma, vs, and ve entries are specific to the w program. 


Not all programs support all entries. There are entries that are not supported by any program. 
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NAME 
tp — DEC/mag tape formats 

DESCRIPTION 
Tp dumps files to and extracts files from DECtape and magtape. The formats of these tapes are 
the same except that magtapes have larger directories. 


Block zero contains a copy of a stand-alone bootstrap program. See reoor(8). 


Blocks 1 through 24 for DECtape (1 through 62 for magtape) contain a directory of the tape. 
There are 192 (resp. 496) entries in the directory; 8 entries per block; 64 bytes per entry. Each 
entry has the following format: 


struct { 
char pathname({32]; 
unsigned short mode; 
char uld; 
char gid: 
char unused 1; 
char size(3]; 
long modtime; 
unsigned short tapeaddr; 
char unused 2[16]; 


unsigned short checksum; 
i 
The path name entry is the path name of the file when put on the tape. If the pathname starts 
with a zero word, the entry is empty. It is at most 32 bytes long and ends in a nuil byte. 
Mode, uid, gid, size and time modified are the same as described under i-nodes (see file system 
filsys(S)). The tape address is the tape block number of the start of the contents of the file. 
Every file starts on a block boundary. The file occupies (size+511)/512 blocks of continuous 
tape. The checksum entry has a value such that the sum of the 32 words of the directory entry 
is zero. 


Blocks above 25 (resp. 63) are available for file storage. 
A fake entry has a size of zero. 


SEE ALSO 
filsys(5), tp(i) 


BUGS 
The pathname, uid, gid, and size fields are too small. 
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NAME 
ttys — terminal initialization data 


DESCRIPTION 7 


The ¢ttys file is read by the init program and specifies which terminal special files are to have a 
process created for them which will allow people to log in. It contains one line per special file. 


The first character of a line is either ‘0’ or ‘1’; the former causes the line to be ignored, the 
latter causes it to be effective. The second character is used as an argument to gerty(8), which 
performs such tasks as baud-rate recognition, reading the login name, and calling /ogin. For nor- 
mal lines, the character is ‘0’; other characters can be used, for example, with hard-wired ter- 
minals where speed recognition is unnecessary or which have special characteristics. (Gerty will 
have to be fixed in such cases.) The remainder of the line is the terminal’s entry in the device 
directory, /dev. 


FILES 
/etc/ttys 


SEE ALSO 
init(8), getty(8), login(1) 
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NAME 

ttytype — data base of terminal types by port 
SYNOPSIS 

/etc/ttytype 
DESCRIPTION 


Ttytype is a database containing, for each tty port on the system, the kind of terminal that is 
attached to it. There is one line per port, containing the terminal kind (as a name listed in 
termcap (5)), a space, and the name of the tty, minus /dev/. 


This information is read by ¢tser(1) and by /ogin(1) to initialize the TERM variabie at login time. 


SEE ALSO 
tset(1), login(1) 


BUGS 
Some lines are merely known as ‘‘dialup’’ or “‘plugboard’’. 
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NAME 


UNIX Programmer’s Manual 


types — primitive system data types 


SYNOPSIS 


#include <sys/types.h> 


DESCRIPTION 


TYPES €5) 


The data types defined in the include file are used in eae system code; some data of these 
types are accessible to user code: 


typedef struct physadr { int r{1]; } *physadr; 
typedef long daddr_t; 
typedef char + caddr_t; 
typedef unsigned short ino _t; 
typedef int swhlk_t; 
typedef int size_t; 
typedef long time_t; 
typedef long label_t{14]; 
typedef short dev t; 
typedef long off_t; 
typedef unsigned char u_char; 
typedef unsigned short u_short; 
typedef unsigned int u_int; 
typedef unsigned long —_u_long; 


/* major part of a device */ 
#define major(x) ((int)(((unsigned) (x) > >8)&0377)) 


/* minor part of a device */ 
#define minor(x) ((int) ((x)&0377)) 


/* make a device number */ 
#define makedev(x,y) ((dev_t)(((x) < <8) | (y))) 


The form daddr_tis used for disk addresses except in an i-node on disk, see fi/sys(5). Times 
are encoded in seconds since 00:00:00 GMT, January 1, 1970. The major and minor parts of a 
device code specify kind and unit number of a device and are installation-dependent. Offsets 
are measured in bytes from the beginning of a file. The /abef/_t variables are used to save the 
processor state while another process is running. 


SEE ALSO 
filsys(5), time(2), Ilseek(2), adb(1) 
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NAME 

utmp, wimp — login records 
SYNOPSIS 

#include <utmp.h> 
DESCRIPTION 


The utmp file allows one to discover information about who is currently using UNIX. The file 
is a sequence of entries with the following structure declared in the include file: 

js 

« Structure of utmp and wtmp files. 


« Assuming the number 8 is unwise. 


«/ 

struct utmp [ 
char _ut_line(8}; /* tty name #/ 
char ut_name(8}; /* user id */ 
long ut time; /* time on «/ 


This structure gives the name of the special file associated with the user’s terminal, the user’s 
login name, and the time of the login in the form of time(2). 


The wep file records all logins and logouts. Its format is exactly like ump except that a null 
user name indicates a logout on the associated terminal. Furthermore, the terminal name ‘°”’ 
indicates that the system was rebooted at the indicated time; the adjacent pair of entries with 
terminal names ‘|’ and ‘}” indicate the system-maintained time just before and just after a date 
command has changed the system’s idea of the time. 


Wimp is maintained by /ogin(1) and init(8). Neither of these programs creates the file, so if it 
is removed record-keeping is turned off. It is summarized by ac(8). 


FILES 
/etc/utmp 
/usr/adm/wtmp 


SEE ALSO 
login(1), init(8), who(1), ac(8) 
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NAME 
uuencode — format of an encoded uuencode file 


DESCRIPTION 
Files output by uuencode(1) consist of a header line, followed by a number of body lines, and a 
trailer line. Uudecode(1) will ignore any lines preceding the header or following the trailer. 
Lines preceding a header must not, of course, look like a header. 


The header line is distinguished by having the first 6 characters “begin ’* The word begin is 
followed by a mode (in octal), and a string which names the remote file. A space separates the 
three items in the header line. 


The body consists of a number of lines, each at most 62 characters long (including the trailing 
newline). These consist of a character count, followed by encoded characters, followed by a 
newline. The character count is a single printing character, and represents an integer, the 
number of bytes the rest of the line represents. Such integers are always in the range from 0 to 
63 and can be determined by subtracting the character space (octal 40) from the character. 


Groups of 3 bytes are stored in 4 characters, 6 bits per character. All are offset by a space to 
make the characters printing. The last line may be shorter than the normal 45 bytes. If the 
size iS not a multiple of 3, this fact can be determined by the value of the count on the last 
line. Extra garbage will be included to make the character count a multiple of 4. The body is 
terminated by a line with a count of zero. This line consists of one ASCII space. 


The trailer line consists of ‘*‘end’’ on a line by itself. 


SEE ALSO 
uuencode(1), uudecode(1), uusend(1), uucp(1), mail(1) 
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NAME 


vfont — font formats for the Benson-Varian or Versatec 


SYNOPSIS 


/usr/lib/vfont/* 


DESCRIPTION 


FILES 


The fonts for the printer/plotters have the following format. Each file contains a header, an 
array of 256 character description structures, and then the bit maps for the characters them- 
selves. The header has the foilowing format: 


struct header {| 


short magic; 

unsigned short size; 

short maxx; 

short maxy; 

short xtnd; 
} header; 


The magic number is 0436 (octal). The maxx, maxy, and xtnd fields are not used at the current 
time. Maxx and maxy are intended to be the maximum horizontal and vertical size of any 
glyph in the font, in raster lines. The size is the size of the bit maps for the characters in bytes. 
Before the maps for the characters is an array of 256 structures for each of the possible charac- 
ters in the font. Each elernent of the array has the form: 


struct dispatch { 
unsigned short addr; 


short nbytes; 
char up; 
char down; 
char left; 
char right; 
short width; 


}; 
The ndytes field is nonzero for characters which actually exist. For such characters, the addr 
field is an offset into the rest of the file where the data for that character begins. There are 
up+down rows of data for each character, each of which has /eft+right bits, rounded up to a 
number of bytes. The width field is not used by vcat, although it is used by vwidth(1) to make 
width tables for trof. It represents the logical width of the glyph, in raster lines, and shows 
where the base point of the next glyph would be. 


/usr/lib/vfont/* 


SEE ALSO 


troff(1), pti(1), vpr(1), vtroff(1), vwidth(1), vfontinfo(1), fed(1) 
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NAME 
wtmp — user login history 
DESCRIPTION 


This file records all logins and logouts. Its format is exactly like utmp(5) except that a null user 
name indicates a logout on the associated typewriter. Furthermore, the typewriter name ‘~’ 
indicates that the system was rebooted at the indicated time; the adjacent pair of entries with 


typewriter names ‘? and ‘}’ indicate the system-maintained time just before and just after a date 
command has changed the system’s idea of the time. 


Wtmp is maintained by /ogin(1) and init(8). Neither of these programs creates the file, so if it 

is removed record-keeping is turned off. It is summarized by ac(1). 
FILES 
7 /usr/adm/wtmp 


SEE ALSO 
utmp(5), login(1), init(8), ac(1), who(]1) 
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NAME 

aardvark — yet another exploration game 
SYNOPSIS 

/usr/games/aardvark 
DESCRIPTION 


Aardvark is yet another computer fantasy simulation game of the adventure/zork genre. This 
one is written in DDL (Dungeon Definition Language) and is intended primarily as an example 
of how to write a dungeon in DDL. 


FILES 
/usr/games/lib/ddirun ddl interpreter 
/usr/games/lib/aardvarkinternal form of aardvark dungeon 


AUTHOR 
Mike Urban, UCLA 


BUGS 
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NAME 

adventure — an exploration game 
SYNOPSIS 

/usr/games/adventure 
DESCRIPTION 


The object of the game is to locate and explore Colossal Cave, find the treasures hidden there, 
and bring them back to the building with you. The program is self-describing to a point, but 
part of the game is to discover its rules. 

To terminate a game, type ‘quit’; to save a game for later resumption, type ‘suspend’. 


BUGS 


Saving a game creates a large executable file instead of just the information needed to resume 
the game. 
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aliens — The alien invaders attack the earth 
SYNIOPSIS 
/usr/games/aliens 
DESCRIPTION 
This is a UNIX version of Space Invaders. The program is pretty much self documenting. 
FILES 
/usr/games/lib/aliens.log Score file 
BUGS 


The program is a CPU hog. It needs to be re-written. It doesn’t do well on terminals that run 
slower than 9600 baud. 
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NAME 

arithmetic — provide drili in number facts 
SYNOPSIS 

/usr/games/arithmetic [ +—x/ ] [ range ] 
DESCRIPTION 


Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the 
answer is correct, it types back “‘Right!’’, and a new problem. If the answer is wrong, it replies 
‘‘What?’’, and waits for another answer. Every twenty problems, it publishes statistics on 
correctness and the time required to answer. 


To quit the program, type an interrupt (delete). 


The first optional argument determines the kind of problem to be generated; +—x/ respec- 
tively cause addition, subtraction, multiplication, and division problems to be generated. One 
or more characters can be given; if more than one is given, the different types of problems will 
be mixed in random order, default is +— 


Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and 
quotients will be less than or equal to the value of range. Default range is 10. 


At the start, all numbers jess than or equal to range are equally likely to appear. If the respon- 
dent makes a mistake, the numbers in the problem which was missed become more likely to 
reappear. 


As a matter of educational philosophy, the program will not give correct answers, since the 
learner should, in principle, be able to calculate them. Thus the program ts intended to provide 
drill for someone just past the first learning stage, not to teach number facts de novo. For 
almost all users, the relevant statistic should be time per problem, not percent correct. 
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NAME 
backgammon — the game 
SYNOPSIS 
/usr/games/backgammon 
DESCRIPTION 


This program does what you expect. It will ask whether you need instructions. 
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NAME 


banner — print large banner on printer 


SYNOPSIS 


/usr/games/banner | ~wz] message ... 


DESCRIPTION 


Banner prints a large, high quality banner on the standard output. If the message is omitted, it 
prompts for and reads one line of its standard input. If —w is given, the output is scrunched 
down from a width of 132 to , suitable for a narrow terminal. If 7 is omitted, it defaults to 
80. 


The output should be printed on a hard-copy device, up to 132 columns wide, with no breaks 
between the pages. The volume is enough that you want a printer or a fast hardcopy terminal, 
but if you are patient, a decwriter or other 300 baud terminal will do. 


BUGS 
Several ASCII characters are not defined, notably <, >, [,],\,*, _, i, },} and ~ Also, the 
characters ",°, and & are funny looking (but in a useful way.) 
The —w option is implemented by skipping some rows and columns. The smiailer it gets, the 
grainier the output. Sometimes it runs letters together. 

AUTHOR | 


Mark Horton 
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NAME 
bed — convert to antique media 


SYNOPSIS 
/usr/games/bed text 


DESCRIPTION 
Bcd converts the literal rext into a form familiar to old-timers. 


SEE ALSO 
dd(Q) 
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NAME 

boggle — play the game of boggle 
SYNOPSIS 

/usr/games/boggle [ + ] [| ++ ] 
DESCRIPTION 


This program is intended for people wishing to sharpen their skills at Boggle (TM Parker 
Bros.). If you invoke the program with 4 arguments of 4 letters each, (e.g. ‘‘boggle appl epie 
moth erhd’’) the program forms the obvious Boggle grid and lists all the words from 
/usr/dict/words found therein. If you invoke the program without arguments, it will generate a 
board for you, let you enter words for 3 minutes, and then tell you how well you did relative to 
/usr/dict/words. : 


The object of Boggie is to find, within 3 minutes, as many words as possible in a 4 by 4 grid of 
letters. Words may be formed from any sequence of 3 or more adjacent letters in the grid. The 
letters may join horizontally, vertically, or diagonally. However, no position in the grid may be 
used more than once within any one word. In competitive play amongst humans, each player is 
given credit for those of his words which no other player has found. 


In interactive play, enter your words separated by spaces, tabs, or newlines. A bell will ring 
when there is 2:00, 1:00, 0:10, 0:02, 0:01, and 0:00 time left. You may complete any word 
Started before the expiration of time. You can surrender before time is up by hitting ‘break’. 
While entering words, your erase character is only effective within the current word and your 
line kill character 1s ignored. 


Advanced players may wish to invoke the program with 1 or 2 +’s as the first argument. The 
first + removes the restriction that positions can only be used once in each word. The second 
+ causes a position to be considered adjacent to itself as well as its (up to) 8 neighbors. 
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NAME 
chase — Try to escape to killer robots 
SYNOPSIS 
/usr/games/chase [ nrodots] { nfences | 
DESCRIPTION 
The object of the game chase is to move around inside of the box on the screen without getting 
eaten by the robots chasing and without running into anything. 


If a robot runs into another robot while chasing you, they crash and leave a junk heap. If a 
robot runs into a fence, it is destroyed. 


If you can survive until all the robots are destroyed, you have won! 


If you do not specify either nrodors or nfences, chase will prompt you for them. 
BUGS 
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NAME | 
chess — the game of chess 
SYNOPSIS 
/usr/games/chess 
DESCRIPTION 
Chess is a computer program that plays class D chess. Moves may be given either in standard 
(descriptive) notation or in algebraic notation. The symbol ‘+’ is used to specify check; ‘o-o’ 
and ‘o-0-0’ specify castling. To play black, type ‘first’; to print the board, type an empty line. 
Each move is echoed in the appropriate notation followed by the program’s reply. 
FILES | 
/usr/lib/book opening ‘book’ 
DIAGNOSTICS 
The most cryptic diagnostic is ‘eh?’ which means that the input was syntactically incorrect. 
WARNING 
Over-use of this program will cause it to go away. 
BUGS 


Pawns may be promoted only to queens. 
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NAME 


ching, fortune — the book of changes and other cookies 


SYNOPSIS 


/usr/games/ching [ hexagram ] 


/usr/games/fortune 


DESCRIPTION 


The / Ching or Book of Changes is an ancient Chinese oracle that has been in use for centuries 
as a source of wisdom and advice. 


The text of the oracle (as it is sometimes known) consists of sixty-four hexagrams, each sym- 
bolized by a particular arrangement of six straight (——-—) and broken (— —) lines. These 


lines have values ranging from six through nine, with the even values indicating the broken 
lines. 


Each hexagram consists of two major sections. The Judgement relates specifically to the matter 
at hand (E.g., ‘‘It furthers one to have somewhere to go.’’) while the Image describes the gen- 
eral attributes of the hexagram and how they apply to one’s own life (‘‘Thus the superior man 
makes himself strong and untiring.’’). 


When any of the lines have the values six or nine, they are moving lines; for each there is an 
appended judgement which becomes significant. Furthermore, the moving lines are inherently 


unstable and change into their opposites; a second hexagram (and thus an additional judge- 
ment) is formed. 


Normally, one consults the oracle by fixing the desired question firmly in mind and then casting 
a set of changes (lines) using yarrow—stalks or tossed coins. The resulting hexagram will be 
the answer to the question. 


Using an algorithm suggested by S. C. Johnson, the Unix oracle simply reads a question from 
the standard input (up to an EOF) and hashes the individual characters in combination with the 
time of day, process id and any other magic numbers which happen to be lying around the sys- 
tem. The resulting value is used as the seed of a random number generator which drives a 
simulated coin—toss divination. The answer is then piped through nroff for formatting and will 
appear on the standard output. 


For those who wish to remain steadfast in the old traditions, the oracle will also accept the 
results of a personal divination using, for example, coins. To do this, cast the change and then 
type the resulting line values as an argument. 


The impatient modern may prefer to settle for Chinese cookies; try fortune. 


SEE ALSO 


It furthers one to see the great man. 


DIAGNOSTICS 


BUGS 


The great prince issues commands, 
Founds states, vests families with fiefs. 
Inferior people should not be employed. 


Waiting in the mud 
Brings about the arrival of the enemy. 


If one is not extremely careful, 
Somebody may come up from behind and strike him. 
Misfortune. 
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NAME 

cribbage — the card game cribbage 
SYNOPSIS 

/usr/games/cribbage 
DESCRIPTION 


Cribbage plays the card game cribbage, with the program playing one hand and the user the 
other. For a complete description of the rules of cribbage, refer to According to Hoyle. 


Cribbage first asks the player whether he wishes to play a short game (‘‘once around’’, to 61) or 
a long game (‘‘twice around’’, to 121). A response of ‘s’ will resuit in a short game, any other 
response will play a long game. 


At the start of the first game, the program asks the player to cut the deck to determine who 
gets the first crib. The user should respond with a number between 0 and 51, indicating how 
many cards down the deck is to be cut. The player who cuts the lower ranked card gets the first 
crib. If more than one game is played, the loser of the previous game gets the first crib in the 
current game. 


For each hand, the program first prints the player’s hand, whose crib it is, and then asks the 
player to discard two cards into the crib. The cards are prompted for one per line, and are 
typed as explained below. 


After discarding, the program cuts the deck (if it is the player’s crib) or asks the player to cut 
the deck (if it’s its crib): in the later case, the appropriate response is a number from QO to 39 
indicating how far down the remaining 40 cards are to be cut. 


After cutting the deck, play starts with the non-dealer (the person who doesn’t have the crib) 
leading the first card. Play continues, as per cribbage, until all cards are exhausted. The pro- 
gram keeps track of the scoring of all points and the total of the cards on the table. 


After play, the hands are scored. The program requests the player to score his hand (and the 
crib, if it is his) by printing out the appropriate cards (and the cut card enclosed in brackets). 
Play continues until one player reaches the game limit (61 or 121). 


A carriage return when a numeric input is expected is equivalent to typing the lowest legal 
value, when cutting the deck this 1s equivalent to choosing the top card. 


Cards are specified as rank followed by suit. The ranks may be specified as one of: ‘a’, ‘2°, ‘3’, 
‘4’, °5", 66’, ‘7’, 8", $9’, ‘ty Sp, ‘qa’, and ‘k’, or alternatively, one of: ‘‘ace’’, “‘two’’, “‘three’’, 
‘“‘four’’, ‘‘five’’, ‘*‘six’’, ‘‘seven’’, ‘‘eight’’, ‘‘nine’’, ‘‘ten’’, ‘‘jack’’, ‘‘queen’’, and ‘‘king’’. 
Suits may be specified as: ‘s’, ‘h’, ‘d’, and ‘c’, or alternatively as: “‘spades’’, “‘hearts’’, ‘‘dia- 
monds’’, and ‘‘clubs’’. A card may be specified as: <rank> “* ”’ <suit>, or: <rank> “° of ”’ 
<suit>. If the single letter rank and suit designations are used, the space separating the suit 
and rank may be left out. Also, if only one card of the desired rank is playable, typing the rank 
is sufficient. For example, if your hand was “2H, 4D, 5C, 6H, JC, KD” and it was desired to 
discard the king of diamonds, any of the following could be typed: ‘*k’’, ‘*king’’, “*kd’’, “‘k d”’, 
‘*k of d’’, ‘king d’’, ‘“‘king of d’’, ‘tk diamonds’’, ‘‘k of diamonds’’, “‘king diamonds”’, or 
‘*king of diamonds’. | 


FILES 
/usr/games/cribbage 


AUTHOR 
Earl T. Cohen 


BUGS 
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NAME 
| doctor — interact with a psychoanalyst 
SYNOPSIS 
/usr/games/doctor 
DESCRIPTION 


Doctor is a lisp-language version of the legendary ELIZA program of Joseph Weizenbaum. This 
script "simulates" a Rogerian psychoanalyst. Type in lower case, and when you get tired or 
bored, type your interrupt character (either control-C or Rubout). Remember to type two car- 
riage returns when you want it to answer. 


In order to run this you must have a Franz Lisp system in /usr/ucb/lisp. 


AUTHORS 
Adapted for Lisp by Jon L White, moved to Franz by John Foderaro, from an original script by 
Joseph Weizenbaum. 


BUG 
It shows how impressed people were willing to be way back then. 
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NAME 


fish — play ‘‘Go Fish”’ 


SYNOPSIS 


/usr/games/fish 


DESCRIPTION 


Fish plays the game of ‘‘Go Fish’’, a childrens’ card game. The Object is to accumulate ‘books’ 
of 4 cards with the same face value. The players alternate turns; each turn begins with one 
player selecting a card from his hand, and asking the other player for all cards of that face 
value. If the other player has one or more cards of that face value in his hand, he gives them 
to the first player, and the first player makes another request. Eventually, the first player asks 
for a card which is not in the second player’s hand: he replies ‘GO FISH!’ The first player then 
draws a card from the ‘pool’ of undealt cards. If this is the card he had last requested, he 
draws again. When a book is made, either through drawing or requesting, the cards are laid 
down and no further action takes place with that face value. 

To play the computer, simply make guesses by typing a, 2, 3, 4, 5, 6, 7, 8, 9, 10, 3, q, or k 
when asked. Hitting return gives you information about the size of my hand and the pool, and 
tells you about my books. Saying ‘p’ as a first guess puts you into ‘pro’ level; The default is 
pretty dumb. 
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NAME 

fortune — print a random, hopefully interesting, adage 
SYNOPSIS 

fortune [ — ] [ —wslao ] 
DESCRIPTION 


Fortune with no arguments prints out a random adage. The flags mean: 


—w Waits before termination for an amount of time calculated from the number of characters 
in the message. This is useful if it is executed as part of the logout procedure to guaran- 
tee that the message can be read before the screen is cleared. 


gs Short messages only. 

~| Long messages only. 

—o Choose from an alternate list of adages, often used for portentially offensive ones. 
a Choose from either list of adages. 

Mail suggestions for new fortunes to "fortune". 


FILES 
/usr/lib/fortunes.dat 


AUTHOR 
Ken Arnold 
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man ~ Computer version of the game hangman 
/usr/games/hangman 


ngman, the computer picks a word from the on-line word list and you must try to guess it. 
The computer keeps track of which letters have been guessed and how many wrong guesses 
you have made on the screen in a graphic fashion. 


/usr/dict/words On-line word list 
Modified for terminal graphics from the original source from BTL by Michaei Toy. 


BUGS 
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NAME 

mille — play Mille Bournes 
SYNOPSIS 

/usr/games/mille [ file ] 
DESCRIPTION 


Mille plays a two-handed game reminiscent of the Parker Brother’s game of Mille Bournes with 


you. The rules are described below. If a file name is given on the command line, the game 
saved in that file is started. | 


When a game is started up, the bottom of the score window will contain a list of commands. 


They are: 
P Pick a card from the deck. This card is placed in the ‘P’ slot in your hand. 
D Discard a card from your hand. To indicate which card, type the number of the card in 


the hand (or ‘‘P’’ for the just-picked card) followed by a <RETURN> or <SPACE>. 
The <RETURN or <SPACE> is required to allow recovery from typos which can be 
very expensive, like discarding safeties. 


U Use a card. The card is again indicated by its number, followed by a <RETURN> or 
<SPACE>. 

O Toggle ordering the hand. By default off, if turned on it will sort the cards in your 
hand appropriately. This is not recommended for the impatient on slow terminals. 

Q Quit the game. This will ask for confirmation, just to be sure. Hitting <DELETE> 
(or <RUBOUT>) is equivalent. 

S Save the game ina file. If the game was started from a file, you will be given an oppor- 


tunity to save it on the same file. If you don’t wish to, or you did not start from a file, 
you will be asked for the file name. If you type a <RETURN> without a name, the 
save will be terminated and the game resumed. 
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Redraw the screen from scratch. The command “L (control ‘L’) will also work. 


WwW Toggle window type. This switches the score window between the startup window (with 
all the command names) and the end-of-game window. Using the end-of-game window 
saves time by eliminating the switch at the end of the game to show the final score. 
Recommended for hackers and other miscreants. 


If you make a mistake, an error message will be printed on the last line of the score window, 
and a bell will beep. 


At the end of each hand or game, you will be asked if you wish to play another. If not, it will 
ask you if you want to save the game. If you do, and the save is unsuccessful, play will be 
resumed as if you had said you wanted to play another hand/game. This allows you to use the 
‘*S””> command to reattempt the save. 
AUTHOR 
Ken Arnold 
(The game itself is a product of Parker Brothers, Inc.) 
SEE ALSO 
curses(3), Screen Updating and Cursor Movement Optimization: A Library Package, Ken Arnold 
CARDS 


Here is some useful information. The number in parentheses after the card name is the 
number of that card in the deck: 
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Hazard Repair Safety 

Out of Gas (2) Gasoline (6) Extra Tank (1) 
Flat Tire (2) Spare Tire (6) Puncture Proof (1) 
Accident (2) Repairs (6) Driving Ace (1) 
Stop (4) Go (14) Right of Way (1) 


Speed Limit (3) End of Limit (6) 


25 — (10), 50 — (10), 75 ~ (10), 100 — (12), 200 — (4) 


RULES 
Object: The point of game is to get a total of 5000 points in several hands. Each hand is a race 
to put down exactly 700 miles before your opponent does. Beyond the points gained by putting 
down milestones, there are several other ways of making points. 


Overview: The game is played with a deck of 101 cards. Distance cards represent a number of 
miles traveled. They come in denominations of 25, 50, 75, 100, and 200. When one is played, 
it adds that many miles to the player’s trip so far this hand. Hazard cards are used to prevent 
your opponent from putting down Distance cards. They can only be played if your opponent 
has a Go card on top of the Battle pile. The cards are Out of Gas, Accident, Flat Tire, Speed 
Limit, and Stop. Remedy cards fix problems caused by Hazard cards played on you by your 
opponent. The cards are Gasoline, Repairs, Spare Tire, End of Limit, and Go. Safety cards 
prevent your opponent from putting specific Hazard cards on you in the first place. They are 
Extra Tank, Driving Ace, Puncture Proof, and Right of Way, and there are only one of each in 
the deck. 


Board Layout: The board is split into several areas. From top to bottom, they are: SAFETY 
AREA (unlabeled): This is where the safeties will be placed as they are played. HAND: These 
are the cards in your hand. BATTLE: This ts the Battle pile. All the Hazard and Remedy 
Cards are played here, except the Speed Limit and End of Limit cards. Only the top card is 
displayed, as it is the only effective one. SPEED: The Speed pile. The Speed Limit and End of 
Limit cards are played here to control the speed at which the player ts allowed to put down 
miles. MILEAGE: Miles are placed here. The total of the numbers shown here is the distance 
traveled so far. 7 


Play: The first pick alternates between the two players. Each turn usually starts with a pick 
from the deck. The player then plays a card, or if this is not possible or desirable, discards one. 
Normally, a play or discard of a single card constitutes a turn. If the card played is a safety, 
however, the same player takes another turn immediately. 


This repeats until one of the players reaches 700 points or the deck runs out. If someone 
reaces 700, they have the option of going for an Extension, which means that the play continues 
until someone reaches 1000 miles. 


Hazard and Remedy Cards: Hazard Cards are played on your opponent’s Battle and Speed 
piles. Remedy Cards are used for undoing the effects of your opponent’s nastyness. 


Go (Green Light) must be the top card on your Battle pile for you to play any mileage, 
unless you have played the Right of Way card (see below). 

Step is played on your opponent’s Go card to prevent them from playing mileage until they 
olay a Go card. 

Speed Limit is played on your opponent’s Speed pile. Until they play an End of Limit they 
can only play 25 or 50 mile cards, presuming their Go card allows them to do even that. 

End of Limit ts played on your Speed pile to nullify a Speed Limit played by your opponent. 

Out of Gas is played on your opponent’s Go card. They must then play a Gasoline card, and 
then a Go card before they can play any more mileage. 
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Flat Tire is played on your opponent’s Go card. They must then play : a Spare Tire card, and 
then a Go card before they can play any more mileage. 

Accident is played on your opponent’s Go card. They must then play a Repairs card, and 
then a Go card before they can play any more mileage. 


Safety Cards: Safety cards prevent your opponent from playing the corresponding Hazard cards 
on you for the rest of the hand. It cancels an attack in progress, and always entitles the player to 
an extra turn. 

Right of Way prevents your opponent from playing both Stop and Speed Limit cards on you. 
It also acts as a permanent Go card for the rest of the hand, so you can play mileage as long as 
there is not a Hazard card on top of your Battle pile. In this case only, your opponent can play 
Hazard cards directly on a Remedy card besides a Go card. 

Extra Tank When played, your opponent cannot play an Out of Gas on your Battle Pile. 

Puncture Proof When played, your opponent cannot play a Flat Tire on your Battle Pile. 

Driving Ace When played, your opponent cannot play an Accident on your Battle Pile. 


Distance Cards: Distance cards are played when you have a Go card on your Battle pile, or a 
Right of Way in your Safety area and are not stopped by a Hazard Card. They can be played in 
any combination that totals exactly 700 miles, except that you cannot play more than two 200 
mile cards in one hand. A hand ends whenever one player gets exactly 700 miles or the deck 
runs out. In that case, play continues until neither someone reaches 700, or neither player can 
use any cards in their hand. If the trip is completed after the cect runs out, this is called 
Delayed Action. ; 


Coup Fourre: This is a French fencing term for a counter-thrust move 
opponents attack. In Mille Bournes, it is used as follows: If an oppone 
and you have the corresponding Safety in your hand, you play it immediately, even before you 
draw. This immediately removes the Hazard card from your Battle pile, and protects you from 
that card for the rest of the game. This gives you more points (see ‘‘Scoring’’ below). 


Scoring: Scores are totaled at the end of each hand, whether or not anyone completed the trip. 
The terms used in the Score window have the following meanings: 
Milestones Played: Each player scores as many miles as they played before the trip ended. 
Each Safety: 100 points for each safety in the Safety area. 
All 4 Safeties: 300 points if all four safeties are played. 
Each Coup Foureé: 300 points for each Coup Fouré accomplished. 


The following bonus scores can apply only to the winning player. 
Trip Completed: 400 points bonus for completing the trip to 700 or 1000. 
Safe Trip: 300 points bonus for completing the trip without using any 200 mile cards. 
Delayed Action: 300 points bonus for finishing after the deck was exhausted. 
Extension: 200 points bonus for completing a 1000 mile trip. 
Shut-Out: 500 points bonus for completing the trip before your opponent played any 
mileage cards. 


Running totals are also kept for the current score for each player for the hand (Hand Total), 
the game (Overall Total), and number of games won (Games). 


MONOP (6) | UNIX Programmer’s Manual 


NAME 
| monop ~ Monopoly game 


SYNOPSIS 
/usr/games/monop | file ] 


DESCRIPTION 

Monop is reminiscent of the Parker Brother’s game Monopoly, and monitors a game between ] 
to 9 users. It is assumed that the rules of Monopoly are known. The garne follows the stan- 
dard rules, with the exception that, if a property would go up for auction and there are only two 
solvent players, no auction is held and the property remains unowned. ‘ 
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t, lends the player money, So it is possible to buy something which you can- 
not afford. However, as soon as a person goes into debt, he must “‘fix the prenle ene 
make himself solvent, before play can continue. Hf this is not posstOle: ., the player’s S pr operty 


reverts to a btee, either a ete r the bank. A player can resign at any time to any person 
or the bank, which puts the prope es on the board, unowned. 


Any time that the response to ; seas iS a siring, 6.g., a name , place OF | 1, y 
°?” to get a list of valid answers. It is not possible to input a negative number, no 
necessary. 
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A Summary of Commands: 


quit: quit game: This allows you to quit the game. [t asks you Wf vou're sure. 
Sym os OP hee § an _ a re) ar es fe et oye pep OY s, 
print: print board: This prints out the current board. The columns have t 


1 


lumin headings are the sarr 


meanings (co ie for the where, own hol 


ings commands): 
Name The first ten characters of the name of the square 


Own . The number of the owner of the property. 


a 
— 


ice The cost of the property (if any) 
Mg This field has a ‘**’ in it (f the property 1s mortgaged 


# If the property is a Utility or Railroad, this ts t 


the owner. if the property is land, this is the , number of houses on it. 


Rent Current rent on the property. If it is not owned, there is no rent. 


where: where players are: Tells you where all the players are. A ‘* indicates the current P 


a 


own holdings: 
List your own holdings, i.2., money, get-out-of-jail-free cards, and property. 


holdings: holdings list: Look at anyone’s holdings. It will ask you whose holdings you wish to 
look at. When you are finished, type ‘‘done’’. 


shell: shell escape: Escape to a shell. When the shell dies, the program continues where 
you left off. . 


mortgage: mortgage property: Sets up a list of mortgageable property, and asks which you wish 
to mortgage. 


unmortgage: 
unmortgage property: Unmortgage mortgaged property. 


buy: buy houses: Sets up a list of monopolies on which you can buy houses. If there is 
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more than one, it asks you which you want to buy for. It then asks you how many 
for each piece of property, giving the current amount in parentheses after the pro- 
perty name. If you build in an unbalanced manner (a disparity of more than one 
house within the same monopoly), it asks you to re-input things. 


sell: Sell houses: Sets up a list of monopolies from which you can sell houses. it operates 
in an analogous manner to buy 
card: card for jail: Use a get-out-of-jail-free card to get out of jail. If you’re not in jail, or 
you don’t have one, it tells you so. 
pay: pay for jail: Pay $50 to get out of jail, from whence you are put on Just Visiting. 
Difficult to do if you’re not there. 
trade: This allows you to trade with another player. It asks you whom you wish to trade 
with, and then asks you what each wishes to give up. You can get a summary at the 
end, and, in all cases, it asks for confirmation of the trade before doing it. 
resign: Resign to another player or the bank. If you resign to the bank, all property reverts 
to its virgin State, and get-out-of-jail free cards revert to the deck. 
save: save game: Save the current game in a file for later play. You can continue play 
after saving, either by adding the file in which you saved the game after the monop 
command, or by using the restore command (see below). It will ask you which file 
you wish to save it in, and, if the file exists, confirm that you wish to overwrite it. 
restore: restore game: Read in a previously saved game from a file. It leaves the file intact. 
roll: Roll the dice and move forward to your new location. If you simply hit the 
<RETURN> key instead of a command, it is the same as typing roll. 
AUTHOR 
Ken Arnold 
FILES 
/usr/games/lib/cards.pck Chance and Community Chest cards 
BUGS 


No command can be given an argument instead of a response to a query. 
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NAME 

number — convert Arabic numerals to English 
SYNOPSIS 

/usr/games/number 
DESCRIPTION 


Number copies the standard input to the standard output, changing each decimal number to a 
fully spelled out version. Punctuation is added to make the output sound well when played 
through speak(1). 


SEE ALSO 
speak (1) 
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NAME 


quiz — test your knowledge 


SYNOPSIS 


/usr/games/quiz [ i file ] [ —t ] [ categoryl category2 ] 


DESCRIPTION 


FILES 


BUGS 


Quiz gives associative knowledge tests on various subjects. It asks items chosen from category! 


and expects answers from category2. If no categories are specified, quiz gives instructions and 
lists the available categories. 


Quiz tells a correct answer whenever you type a bare newline. At the end of input, upon inter- 
rupt, or when questions run out, quiz reports a score and terminates. 


The -—t flag specifies ‘tutorial’ mode, where missed questions are repeated later, and material is 
gradually introduced as you learn. 


The i flag causes the named file to be substituted for the default index file. The lines of 
these files have the syntax: 


line = category newline | category ‘:’ line 
category = alternate | category { alternate 
alternate = empty | alternate primary 

primary = character | ‘[? category ‘]’| option 
option = ‘{’ category ‘}’. 


The first category on each line of an index file names an information file. The remaining 
categories specify the order and contents of the data in each line of the information file. Infor- 
mation files have the same syntax. Backslash ‘\’ is used as with sh(1) to quote syntactically 
significant characters or to insert transparent newlines into a line. When either a question or its 
answer is empty, quiz will refrain from asking it. 


/usr/games/quiz.k/* 


The construct ‘alab’ doesn’t work in an information file. Use ‘a{b}’. 
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NAME 
rain — animated raindrops display 
SYNOPSIS 
rain 
DESCRIPTION 


Rain’s display is modeled after the VAX/VMS program of the same name. The terminal has to 
be set for 9600 baud to obtain the proper effect. 
As with all programs that use termcap, the TERM environment variable must be set (and 
exported) to the type of the terminal being used. 


FILES 
/etc/termcap 


AUTHOR 
Eric P. Scott 
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NAME 
rogue — Exploring The Dungeons of Doom 

SYNOPSIS 
rogue [ save_file } 

DESCRIPTION 
Rogue is a computer fantasy game with a new twist. It is crt oriented and the object of the 
game is to survive the attacks of various monsters and get a lot of gold, rather than the puzzle 
solving orientation of most computer fantasy games. 


To get started you really only need to know two commands. The command ? will give you a 


list of the available commands and the command / will identify the things you see on the 
screen. 


To win the game (as opposed to merely playing to beat other people high scores) you must 
locate the Amulet of Yendor which is somewhere below the 20th level of the dungeon and get 
it out. Nobody has achieved this yet and if somebody does, they will probably go down in his- 
tory as a hero among heros. 


When the game ends, either by your death, when you quit, or if you (by some miracle) manage 
to win, rogue will give you alist of the top-ten scorers. The scoring is based entirely upon how 
much gold you get. There is a 10% penalty for getting yourself killed. 
For more detailed directions, read the document A Guide to the Dungeons of Doom. 
FILES 
/usr/games/lib/rogue_roll Score file 
“/rogue.sav Default save file 
SEE ALSO 
Michael C. Toy, A guide to the Dungeons of Doom 
BUGS 
Probably infinite. Currently known bugs are: Sometimes you are still hungry even after you eat 


food and sometimes you get a monster on the screen in reverse video which may or may not 
cause a core dump. 
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NAME 
snake, snscore — display chase game 
SYNOPSIS 
/usr/games/snake [ ~wa] [ —I7] 
/usr/games/snscore 
DESCRIPTION 


Snake is a display-based game which must be played on a CRT terminal from among those sup- 
ported by vi(1). The object of the game is to make as much money as possible without getting 
eaten by the snake. The —I and —w options allow you to specify the length and width of the 
field. By default the entire screen (except for the last column) is used. 


You are represented on the screen by an I. The snake is 6 squares long and is represented by 
S’s. The money is $, and an exit is #. Your score is posted in the upper left hand corner. 


You can move around using the same conventions as vi(1), the h, j, k, and | keys work, as do 
the arrow keys. Other possibilities include: 


sefc These keys are like hjkl but form a directed pad around the d key. 


HJKL These keys move you all the way in the indicated direction to the same row or column 
as the money. This does not let you jump away from the snake, but rather saves you 
from having to type a key repeatedly. The snake still gets all his turns. 


SEFC Likewise for the upper case versions on the left. 


ATPB These keys move you to the four edges of the screen. Their position on the keyboard 
is the mnemonic, e.g. P is at the far right of the keyboard. 


X This lets you quit the game at any time. 
p Points in a direction you might want to go. 

Ww Space warp to get out of tight squeezes, at a price. 
Shell escape 


TL Suspend the snake game, on systems which support it. Otherwise an interactive shell is 
Started up. 


To earn money, move to the same square the money is on. A new $ will appear when you earn 
the current one. As you get richer, the snake gets hungrier. To leave the game, move to the 
exit (#). 


A record is kept of the personal best score of each player. Scores are only counted if you leave 
at the exit, getting eaten by the snake is worth nothing. 


As in pinball, matching the last digit of your score to the number which appears after the game 
is worth a bonus. 


To see who wastes time playing snake, run /usr/games/snscore . 


FILES 
/usr/games/lib/snakerawscores database of personal bests 
/usr/games/lib/snake.log log of games played 
/usr/games/busy program to determine if system too busy 
BUGS 


When playing on a smail screen, it’s hard to tell when you hit the edge of the screen. 


The scoring function takes into account the size of the screen. A perfect function to do this 
equitably has not been devised. 
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NAME 
trek — trekkie game 


SYNOPSIS 
/usr/games/trek [ [ —a} file J 


DESCRIPTION 


Trek is a game of space glory and war. Below is a summary of commands. For complete docu- 
mentation, see Trek by Eric Allman. 


If a filename is given, a log of the game is written onto that file. If the —a flag is given before 
the filename, that file is appended to, not truncated. 


The game will ask you what length game you would like. Valid responses are ‘‘short’’, 
‘‘medium’’, and “‘long’’. You may also type ‘“‘restart’’, which restarts a previously saved game. 
You will then be prompted for the skill, to which you must respond ‘‘novice’’, ‘‘fair’’, ‘“‘good’’, 


‘““expert’’, ‘‘commadore’’, or “‘impossible’’. You should normally start out with a novice and 
work up. 


In general, throughout the game, if you forget what is appropriate the game will tell you what it 
expects if you just type in a question mark. | 


AUTHOR 
Eric Allman 
SEE ALSO 
/usr/doc/ trek 
COMMAND SUMMARY 
abandon capture 
cloak up/down 
computer request; ... damages 
destruct dock 
help impulse course distance 
Irscan move course distance 


phasers automatic amount 
phasers manual amtl course] spread] ... 
torpedo course [yes] angle/no 


ram course distance rest time 

shell shields up/down 
srscan [yes/no] 

status terminate yes/no 
undock visual course 


warp warp_factor 
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NAME 
worm — Play the growing worm game 


SYNOPSIS 
worm [ size } 


DESCRIPTION 
In worm, you are a little worm, your body is the *o"’s on the screen and your head is the "@". 
You move with the hjki keys (as in the game snake). If you don’t press any keys, you continue 
in the direction you last moved. The upper case HJKL keys move you as if you had pressed 
several (9 for HL and 5 for JK) of the corrosponding lower case key (unless you run into a 
digit, then it stops). 


On the screen you will see a digit, if your worm eats the digit is will grow longer, the actual 
amount longer depends on which digit it was that you ate. The object of the game is to see 
how long you can make the worm grow. 


The game ends when the worm runs into either the sides of the screen, or itself. The current 
score (how much the worm has grown) is kept in the upper left corner of the screen. 
The optional argument, if present, is the initial length of the worm. 

BUGS 
If the initial length of the worm is set to less than one or more than 75, various strange things 
happen. 
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NAME 

worms — animate worms on a display terminal 
SYNOPSIS 

worms [ -field ] { -length # ] [ -number # ] [ -trail ] 
DESCRIPTION 


Brian Horn (cithep!bdh) showed me a TOPS-20 program on the DEC-2136 machine called 


WORM, and suggested that I write a similar program that would run under Unix. I did, and no 
apologies. 


-field makes a “field” for the worm(s) to eat; -trail causes each worm to leave a trail behind it. 
You can figure out the rest by yourself. : 


FILES 

/etc/termcap 
AUTHOR 

Eric P. Scott 
SEE ALSO 

Snails, by Karl Heuer 


DIAGNOSTICS 
Invalid length 
Value notin range 2 <™ length <= 1024 


Invalid number of worms 
Value not in range 1 <= number < = 40 


TERM: parameter not set 
The TERM environment variable is not defined. Do 


TERM =terminal type 
export TERM 


Unknown terminal type 


Your terminal type (as determined from the TERM environment variable) is not 
defined in /etc/termcap. 


Terminal not capable of cursor motion 
Your terminal is too stupid to run this program. 


Out of memory 
This should never happen on a VAX. 


BUGS 
The lower-right-hand character position will not be updated properly on a terminal that wraps at 
the right margin. 


Terminal initialization is not performed. 


There should be an option to have the worms eat Pink Floyd lyrics. 
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NAME 

wump -- the game of hunt-the-wumpus 
SYNOPSIS 

/usr/games/wump 
DESCRIPTION 


Wump plays the game of ‘Hunt the Wumpus.’ A Wumpus is a creature that lives in a cave with 
several rooms connected by tunnels. You wander among the rooms, trying to shoot the 
Wumpus with an arrow, meanwhile avoiding being eaten by the Wumpus and falling into Bot- 
tomless Pits. There are also Super Bats which are likely to pick you up and drop you in some 
random room. 


The program asks various questions which you answer one per line; it will give a more detailed 

description if you want. 

This program is based on one described in People's Computer Company, 2,2 (November 1973). 

BUGS | | | | | 
It will never replace Space War. 
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NAME 


zork — the game of dungeon 


SYNOPSIS 


/usr/games/zork 


DESCRIPTION 


FILES 


BUGS 


Dungeon is a computer fantasy simulation based on Adventure and on Dungeons & Dragons, 
Originally written by Lebling, Blank,.and Anderson of MIT. In it you explore a dungeon made 
up of various rooms, caves, rivers, and so on. The object of the game is to collect as much 
treasure as possible and stow it safely in the trophy case (and, of course, to stay alive.) 


Figuring out the rules is part of the game, but if you are stuck, you should start off with “‘open 


mailbox’’, ‘‘take leaflet’’, and then ‘‘read leaflet’’. Additional useful commands that are not 
documented include: 


quit (to end the game) 


‘cmd = (the usual shell escape convention) 


> (to save a game) 
< (to restore a game) 
/usr/games/lib/ds 


We don’t have the source, only a pdp-11 binary that has been severely munged to get it to 
work on V7 Unix. (The original binary was for RSX-11, which was patched for V6, and then 
patched for V7.) 
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NAME 
ascli — map of ASCII character set 
SYNOPSIS 
cat /usr/pub/ascii 
DESCRIPTION 
[000 nul|001 soh|002 
1010 bs |011 ht |012 
1020 dle|021 dcl/022 
1030 can|031 em |032 
1040 sp [041 ! [042 " 1043 
1050 ( {051 ) {052 « 1053 
1060 O {061 1 {062 2 |063 
1070 8 |071 9 |072 : |073 
1100 @ |101 A [102 B |103 
1110 H{il1 1 bL12 3-113 
1120 P (121 Q |122 R 1123 
30° XM 13h °Y. M192 21193 
1140 ° [141 a [142 b |143 
1150 bh [151 i [152 j 1153 
1160 p {161 q {162 r [163 
170. xan. yclI> 2 7173 
| 00 nul] 01 soh| 02 stx| 03 
| 08 bs | 09 ht | Oa nl | Ob 
| 10 dle] 11 del| 12 dce2] 13 
| 18 can| 19 em | la sub| 1b 
20 'sp-| 21. 2. 22. * |.33 
| 28 ( | 29 ) | 2a » | 2b 
| 30 O | 31 1 | 32 2 | 33 
| 38 8 | 39 9 | 3a : | 3b 
| 40 @| 41 Al 42 Bl 43 
| 48 H| 49 I | 4a J | 4b 
| 50 P| 51 Q| 52 R| 53 
| 58 X | 59 Y | 5a Z| Sb 
| 60 * | 61 a | 62 bf 63 
| 68 h| 69 i | 6a j | 6b 
70° ph Fie ee 92: e173 
| 78 x | 79 y | 7a z | 7b 
FILES 
/usr/pub/ascii 
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Ascii is a map of the ASCII character set, to be printed as needed. It contains: 


stx|003 etx|004 eot|005 
nl {013 vt [014 np |015 
de2|023 de3|024 dc4]025 
sub|033 esc|034 fs |035 


# |044 


wo + 
on) 
sa 
> 


—“a FO ANARO-: 
ee 
nO 
fs 


—Nn FO nmNA O°: 


$ {045 
. LOSS 
4 1065 
< |075 
D [105 
L 1115 
T 125 
\ 1135 
d [145 
1 1155 
t [165 
| {175 
eot| 05 
np | Od 
de4| 15 
fs | 1d 
$ | 25 
, | 2d 
4 | 35 
< | 3d 
D | 45 
L | 4d 
T | 55 
\ | Sd 
d | 65 
1 | 6d 
tn 7s 
| | 7d 


enq|006 
cr |016 
nak |026 
gs |036 
% 1046 
— |056 
5 |066 
= |076 
E |106 
M [116 
U 1126 
] 1136 
e [146 


ack|007 
so |017 
syn|027 
rs |037 
& |047 
. {057 
6 |067 
> |077 
F |107 
N |117 
V [127 


i<¢ omy 
ponents 
La 
atte 


—<ZnVa-: 


I< om 


be | | 
si | 
etb| 
us 
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NAME 
eqnchar — special character definitions for eqn 
SYNOPSIS 
eqn /usr/pub/eqnchar [ files } | troff { options ] 
neqn /usr/pub/eqnchar [ files | | nroff [ options ] 


DESCRIPTION 
Eqnchar contains troff and nroff character definitions for constructing characters that are not 
available on the Graphic Systems typesetter. These definitions are primarily intended for use 
with egn and negn. It contains definitions for the following characters 


ciplus B | i square O 
citimes ® langle ( circle O. 
wig oe rangle | blot i 
-wig = Abar Ai builet 8 
> wig 2 ppd - prop « 
< wig < <-> 2 empty a) 
mE Wig aii <=> pee member € 
star mt |< < nomem  & 
bigstar * > > cup U 
am dof me ang i cap N 
orsign V rang L ined c 
andsign 3dot subset 
a de] 4 thf -_ supset i 
oppA Vv quarter Vo !subset G 
oppE = Squarter Isupset 2 
angstrom A degree . 

FILES 
/usr/pub/eqnchar 

SEE ALSO 


troff(1), een(1) 
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NAME 

greek — graphics for extended TTY-37 type-box 
SYNOPSIS 

cat /usr/pub/greek [| greek —Tterminal ] 
DESCRIPTION 


Greek gives the mapping from ascii to the ‘shift out’ graphics in effect between SO and SI on 
mode! 37 Teletypes with a 128-character type-box. These are the default greek characters pro- 
duced by nroff. The filters of greek(1) attempt to print them on various other terminals. The 


file contains: 
alpha a A beta B B gamma y \ 
GAMMA r eG delta 6 D DELTA A WwW 
epsilon e § zeta ~ Q eta 7 N 
THETA e T theta 6 QO lambda A L 
LAMBDA A £E mu pw iM nu y @ 
Xl —& X pi wr J PI I P 
rho p K sigma o Y SIGMA L. 
tau r «if phi @ U PHI o® F 
psi yw iV PSI VY H omega wo C 
OMEGA Q Z nabla Vf not en 
| partial dq | integral f 
SEE ALSO 
greek(1) 
troff(1) 
/~3 
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NAME 
hier — file system hierarchy 


DESCRIPTION 
The following outline gives a quick tour through a representative directory hierarchy. 


/ root 
/vmunix 

the kernel binary (UNIX itself) 
/jost tfound 

directory for connecting detached files for fsck(5) 
/dev/ devices (4) 

console 

main console, ¢ty(4) 

tty® terminals, ¢ry(4) 

rp? disks, Ap(4) 

trrp= raw disks, Ap(4) 

up UNIBUS disks up(4) 


/bin/ utility programs, cf /usr/bin/ (1) 


as assembler 
cc C compiler executive, cf /lib/ccom, /lib/cpp, /lib/c2 
csh C shell 


/\ib/ object libraries and other stuff, cf /usr/lib/ 
libc.a system calls, standard I/O, etc. (2,3,3S) 


ccom C compiler proper 
cpp C preprocessor 
€2 C code improver 


/etc/ essential data and maintenance utilities, sect (8) 
dump dump program dump(8) 
passwd password file, passwd(5) 
group group file, group(5) 
motd message of the day, login(1) 
termecap 
description of terminal capabilities, termcap(5) 
ttytype table of what kind of terminal is on each port, styype(5) 
mtab mounted file table, miad(5) 
dumpdates 
dump history, dump(8) 
fstab _ file system configurtion table fsrab(5) 
ttys _— properties of terminals, tnys(5) 
getty part of login, getry(8) 
init the parent of all processes, init. vm(8) 
re shell program to bring the system up 
cron _ the clock daemon, cron(8) 
mount mount(8) 
wall wall(8) 


/‘tmp/ temporary files, usually on a fast device, cf /usr/tmp/ 
es used by ed(1) 
ctm* used by cc(1) 
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/usr/ general-pupose directory, usually a mounted file system 
adm/ administrative information 
wimp login history, utmp(5) 
messages 
hardware error messages 
tracct phototypesetter accounting, roff(1) 
lpacct line printer accounting /pr(1) 
vaacct, vpacct 
varian and versatec accounting vpr(1), veroffl), vpac(1) 
/usr /bin 
utility programs, to keep /bin/ small 
tmp/ temporaries, to keep /tmp/ small 
stme used by sort(1) 
raster used by plor(1) 
dict/. word lists, etc. 
words principal word list, used by /ook(1) 
spellhist 
history file for spel/(1) 
games/ 
hangman 
lib/ library of stuff for the games 
quiz.k/ what quiz(6) knows 
index category index 
africa countries and capitals 


include/ 
standard #include files 
a.out.h object file layout, a.our(5) 
stdio.h standard I/O, stdio(3) 
math.h (3M) 


sys/_—_ system-defined layouts, cf /usr/sys/h 
lib/ object libraries and stuff, to keep /lib/ small 

atrun scheduler for ar(1) 

lint/ _utility files for lint 
lint (12) 

subprocesses for linr(1) 

llib-lc dummy declarations for /lib/libc.a, used by linr(1) 
llib-lm dummy declarations for /lib/libe.m 


struct/ passes of strucr(1) 


tmac/ macros for troff{1) 
tmac.an 
macros for man(7) 
tmac.s macros for ms(7) 


font/ fonts for rofl) 
frR Times Roman 
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iB Times Bold 


uucp/ programs and data for uucp(]) 
L.sys remote system names and numbers 
uucico the reali copy program 


units conversion tables for units(1) 
eign _ilist of English words to be ignored by pex(1) 
/ust/ man/ | 
volume | of this manual, man(i) 

manO/ general 
intro. introduction to volume 1, ms(7) format 
XX template for manual page 

manl/ chapter | 
as. 1 
mount.1m 


catl/ preformatted pages for section | 


msgs/ messages, cf msgs(1) 

bounds highest and lowest message 
new/ binaries of new versions of programs 
preserve/ 

editor ternporaries preserved here after crashes/hangups 
public/ binaries of user programs - write permission to everyone 
spool/ delayed execution files 

at/ used by ar(1) 

ipd/ used by ipr(1) 

lock present when line printer is active 


cf copy of file to be printed, if necessary 
df daemon control file, (pd(8) 
tfe transient control file, while [pris working 
uucp/ work files and staging area for uucp(1) 
LOGFILE 
summary log 


LOG.« fog file for one transaction 
mail/ mailboxes for mail(1) 
name mail file for user name 
name.\ock 
lock file while name is receiving mail 
secretmail/ 
like mail/ 
uucp/ work files and staging area for uucp(1) 
LOGFILE 
summary log 
LOG.=« log file for one transaction 
wd initial working directory of a user, typically wdis the user’s login name 
profile set environment for sh(1), environ(5) 
project 
what you are doing (used by ( finger(1) ) 
<shre startup file for csh(1) 
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xre_— startup file for ex{1) 
plan what your short-term plans are (used by finger(1) ) 
metre startup file for ner(1) 
smsgsrc 
startup file for msgs(1) 
-Mailrc startup file for mail(1) 
calendar 
user’s datebook for calendar(1) 
doc/ papers, mostly in volume 2 of this manual, typically in ms(7) format 
as/ assembler manual 
C C manual 


src/ 
source programs for utilities, etc. 
cmd/ source of commands 

as/ assembler 

ar.c source for ar(1) 


troff/ source for nroffand trofl)) 
font/ source for font tables, /usr/lib/font/ 
ftR.c Roman 


term/ terminal characteristics tables, /usr/lib/term/ 
tab300.c 
DASI 300 


games/ source for /usr/games 
libe/ source for functions in /lib/libc.a 
crt/ C runtime support 
csu/ _—s Startup and wrapup routines needed with every C program 
crt0.s regular startup 
mert0.s modified startup for cc —p 
sys/ system calls (2) 
access.s 
alarm.s 


stdio/ standard I/O functions (3S) 
fgets.c 
fopen.c 


gen/ other functions in (3) 
abs.c 


local/ source which isn't normally distributed 
new/ source for new versions of commands and library routines 
old/ source for old versions of commands and library routines 
sys/ system source 
h/ header (include) files 
acct.h acct(5) 
stat.h  star(2) 


HIER (7) 


/-7 
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sys/ system source proper 
main.c 
pipe.c 
sysent.c 
system entry points 
ucb/ _ binaries of programs developed at UCB 


edit editor for beginners 
ex command editor for experienced users 


mail mail reading/sending subsystem 
man on line documentation 


Di Pascal translator 
px Pascal interpreter 
Vi visual editor 


SEE ALSO 

Is(1), apropos(1), whatis(1), whereis(1), finger(1), which (1), ncheck(8), find(1), grep(1) 
BUGS 
The position of files is subject to change without notice. 
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NAME 


man — macros to typeset manual 


SYNOPSIS 


nroff —man file ... 


troff —man file ... 


DESCRIPTION 


These macros are used to lay out pages of this manual. A skeleton page may be found in the 
file /usr/man/man0O/xx. 

Any text argument ¢ may be zero to six words. Quotes may be used to include blanks in a 
‘word’. If text is empty, the special treatment is applied to the next input line with text to be 


printed. In this way .I may be used to italicize a whole line, or .SM followed by .B to make 
small bold letters. 


A prevailing indent distance is remembered between successive indented paragraphs, and is 


reset to default value upon reaching a non-indented paragraph. Default units for indents / are 
ens. 


Type font and size are reset to default values before each paragraph, and after processing font 
and size setting macros. 


These strings are predefined by ~man: 
\fR ‘® ‘(Reg)’ in nrofft. 
\*S Change to default type size. 


FILES 
/usr/lib/tmac/tmac.an 
/usr/man/man0/xx 
SEE ALSO 
troff(1), man(1) 
BUGS 
Relative indents don’t nest. 
REQUESTS 
Request Cause If no Explanation 
Break Argument 
aveet no /==n.t.J.* Text tis bold. 
Blt no  ¢=n.t.l. Join words of t alternating bold and italic. 
BR ¢ no tnt... Join words of t alternating bold and Roman. 
.DT no Si li... Restore default tabs. 
HP i yes i™p.i.* Set prevailing indent to i. Begin paragraph with hanging indent. 
oe no meen.t.i. Text tis italic. 
IB ¢ no m=n.t.l. Join words of ¢ alternating italic and bold. 
AP xi yes x™™ Same as .1P with tag x. 
IR ¢ no m=n.t.l. Join words of ¢ alternating italic and Roman. 
Ae yes - Same as .PP. 
PD d no d= 4y Interparagraph distance is d. 
rr yes - Begin paragraph. Set prevailing indent to .51. 
RE yes - End of relative indent. Set prevailing indent to amount of starting .RS. 
RB t no t=n.t.l. Join words of ¢ alternating Roman and bold. 
Rit no tmnt... Join words of t alternating Roman and italic. 
.RS i yes (= ).1. Start relative indent, move left margin in distance i. Set prevailing indent to 
.5i for nested indents. 
SH t yes ¢=n.t..  Subhead. 
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SM ¢ no entl Text cis small. 


TH acxyes - Begin page named a of chapter c; x is extra commentary, e.g. ‘local’, for 


page foot. Set prevailing indent and tabs to .4i. 

Set prevailing indent to i Begin indented paragraph with hanging tag given 
by next text line. If tag doesn’t fit, place it on separate line. 

* n.t.l. = next text line; p.1. = prevailing indent 


TP i yes) i™ Dai. 
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NAME 
me — macros for formatting papers 


SYNOPSIS 
nroff —me [ options ] file ... 
troff —me [ options ] file ... 


DESCRIPTION 


This package of nrojf and troff macro definitions provides a canned formatting facility for tech- 


nical papers in various formats. When producing 2-column output on a terminal, filter the out- 
put through co/(1). 


The macro requests are defined below. Many a»roffand troff requests are unsafe in conjunction 
with this package, however these requests may be used with impunity after the first .pp: 


.bp begin new page 
br break output line here 
pn insert n spacing lines 
isn (line spacing) n=1 single, n==2 double space 
na no alignment of right margin 
cen center next n lines 
-uln underline next n lines 
SZ +n add n to point size 
Output of the eqn, negn, refer, and 1b/(1) preprocessors for equations and tables is acceptable as 
input. 
FILES 
/usr/lib/tmac/tmac.e 
/usr/lib/me/* 
SEE ALSO 
eqn(1), troff(1), refer(1), tbl(1) 
—me Reference Manual, Eric P. Allman 
Writing Papers with Nroff Using —me 
REQUESTS 
In the following list, ‘initialization’? refers to the first .pp, .lp, .ip, .np, .sh, or .uh macro. This 
list is incomplete; see The —me Reference Manual for interesting details. 


Request Initial Cause Explanation 
Value Break 


Ae - yes Begin centered block 

(d “ no Begin delayed text 

Af * no Begin footnote 

mC ° yes Begin list 

(gq - yes Begin major quote 

Nex - no Begin indexed item in index x 
(2 - no Begin floating keep 

Je - yes End centered block 

Jd - yes End delayed text 

Jf - yes End footnote 

Jl ° yes End list 

q - yes End major quote 

x - yes End index item 

JZ - yes End floating keep 

t+ mH - no Define paper section. m defines the part of the paper, and can be C (chapter), 


A (appendix), P (preliminary, e.g., abstract, table of contents, etc.), B 


Ss _ 2h 4 q Tvs : bs | 7 i~11 
a eee, eee pene nen Yay, SEY ot a TVs/1TK4/70 
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eo ee ee 


yes 
yes 
yes 
yes 
yes 


yes 
yes 
yes 

no 


no 
yes 


yes 
no 
no 
no 
no 
no 
no 
no 
yes 
no 
yes 
yes 
no 


yes 
no 
no 
yes 
yes 
no 
no 
no 


yes 


no 
no 
no 
yes 
no 
yes 
no 
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(bibliography), RC (chapters renumbered from page one each chapter), or RA 
(appendix renumbered from page one). 

Begin chapter (or appendix, etc., as set by .++). Tis the chapter title. 

One column format on a new page. 

Two column format. 

Space after equation produced by eqn or neqn. 

Precede equation, break out and add space. Equation number is y. The 
optional argument x may be / to indent equation (default), LZ to left-adjust the 
equation, or C to center the equation. 

End table. 
End heading section of table. 
Begin table; if xis H table has repeated heading. 

Set up for ACM style output. A is the Author’s name(s), AN is the total 
number of pages. Must be given before the first initialization. 

Print x in boldface; if no argument switch to boldface. 

Augments the base indent by va. This indent is used to set the indent on regular 
text (like paragraphs). 

Begin new column 

Print x in bold italics (nofill only) 

Print x in a box (nofill only). 

Set even footer tox y Zz 

Set even header to x y z 

Set footer tox y z 

Supress headers and footers on next page. 

Set header tox y 2 

Draw a horizontal line 

Italicize x; if x missing, italic text follows. 

Start indented paragraph, with hanging tag x. Indentation is y ens (default 5). 
Start left-blocked paragraph. 

Read in a file of local macros of the form .*x. Must be given before initializa- 
tion. 

Start numbered paragraph. 

Set odd footerto x y z 

Set odd header tox y z 

Print delayed text. 

Begin paragraph. First line indented. 

Roman text follows. 

Reset tabs to default values. 

Read in a file of special characters and diacritical marks. Must be given before 
initialization. 

Section head follows, font automatically bold. 7 is level of section, x is title of 
section. 

Leave the next page blank. Only one page is remembered ahead. 

Augment the point size by nm points. 

Produce the paper in thesis format. Must be given before initialization. 

Begin title page. 

Underline argument (even in trof). (Nofill only). 

Like .sh but unnumbered. 

Print index x. 
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NAME 
ms — macros for formatting manuscripts 


SYNOPSIS 
nroff —ms [ options ] file ... 
troff —ms [ options ] file ... 


DESCRIPTION 


This package of nroff and troff macro definitions provides a canned formatting facility for tech- 


nical papers in various formats. When producing 2-column output on a terminal, filter the out- 
put through co/(1). : 


The macro requests are defined below. Many nroffand troff requests are unsafe in conjunction 
with this package, however these requests may be used with impunity after the first .PP: 
.bp begin new page 
.br break output line here 
Sp n insert n spacing lines 
sn (line spacing) n=1 single, n==2 double space 
Ma no alignment of right margin 
Output of the eqn, neqn, refer, and tbi(1) preprocessors for equations and tables is acceptable as 
input. 
FILES 
/usr/lib/tmac/tmac.s 


SEE ALSO 
eqn(1), troff(1), refer(1), tbi(1) 
REQUESTS 


Request Initial Cause Explanation 
Value Break 


AC yes yes One column format on a new page. 

2¢ no yes Two column format. 

.AB no yes Begin abstract. 

AE ° yes End abstract. 

Al no yes Author’s institution follows. Suppressed in TM. 

AT no yes. Print ‘Attached’ and turn off line filling. 

AU xy no yes: Author’s name follows. x is location and y is extension, ignored except in TM. 

Bx no no Print xin boldface; if no argument switch to boldface. 

Bl no yes Begin text to be enclosed in a box. 

.B2 no  yes_ End text to be boxed. print it. 

.BT date no Bottom title, automatically invoked at foot of page. May be redefined. 

BX x no no _ Print xin a box. 

CS x. « yes Cover sheet info if TM format, suppressed otherwise. Arguments are number 
of text pages, other pages, total pages, figures, tables, references. 

.CT no yes Print ‘Copies to’ and enter no-fill mode. 

.DAx  nroff no ‘Date line’ at bottom of page is x. Default is today. 

.DE ° yes End displayed text. Implies .KE. 


DS -X no yes Start of displayed text, to appear verbatim line-by-line. x=I for indented 
display (default), x=L for left-justified on the page, x=C for centered, x=B 
for make left-justified block, then center whole block. Implies .KS. 


Gr no - Print document in BTL format for ‘Engineer’s Notes.’ Must be first. 
EN - yes Space after equation produced by eqn or neqn. 
EQxy - yes  Precede equation; break out and add space. Equation number is y. The 


optional argument x may be / to indent equation (default), L to left-adjust the 
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FE “ 
FS no 
.HO ° 

a no 
JH no 
IM no 
IPxy no 
KE ~ 
KF no 
KS no 
LG no 
ACP yes 
MF ~ 
.MH - 
.MR ° 
ND date troff 
NH a - 
NL yes 
OK - 
PP no 
PT pg # 
PY - 
QE ” 
.QP - 
QS ~ 
R yes 
.RE - 
.RP no 
.RS - 
SOX no 
OH - 
SM no 
TAx.. 5 
TE - 

A @ = | ° 
ee no 
.IM x... 0 
IR <x ‘ 
IS x - 
UULx  - 
.UX - 
.WH - 
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equation, or C to center the equation. 

End footnote. 

Start footnote. The note will be moved to the bottom of the page. 

‘Bell Laboratories, Holmdel, New Jersey 07733’. 

Italicize x, if x missing, italic text follows. 

‘Bell Laboratories, Naperville, Illinois 60540’ 

Print document in BTL format for an internal memorandum. Must be first. 


_ Start indented paragraph, with hanging tag x. Indentation is y ens (default 5). 


End keep. Put kept text on next page if not enough room. 

Start floating keep. If the kept text must be moved to the next page, float later 
text back to this page. 

Start keeping following text. 

Make letters larger. 

Start left-blocked paragraph. 

Print document in BTL format for ‘Memorandum for File.’ Must be first. 

‘Beil Laboratories, Murray Hill, New Jersey 07974’. 

Print document in BTL format for ‘Memorandum for Record.’ “Must be first. 
Use date supplied (if any) only in special BTL format positions; omit from page 
footer. 

Same as .SH, with section number supplied automatically. Numbers are mul- 
tilevel, like 1.2.3, where n tells what level is wanted (default is 1). 

Make letters normal size. 

‘Other keywords’ for TM cover sheet follow. 

Begin paragraph. First line indented. 

Page title, automatically invoked at top of page. May be redefined. 

‘Bell Laboratories, Piscataway, New Jersey 08854’ 

End quoted (indented and shorter) material. 

Begin single paragraph which is indented and shorter. 

Begin quoted (indented and shorter) material. 

Roman text follows. 

End relative indent level. 

Cover sheet and first page for released paper. Must precede other requests. 
Start level of relative indentation. Following .IP’s are measured from current 
indentation. 

Insert signature(s) of author(s), ignored except in TM. x is the reference line 
(initials of author and typist). 

Section head follows, font automatically bold. 

Make letters smaller. 

Set tabs in ens. Default is 5 1015... 

End table. 

End heading section of table. 

Title follows. 

Print document in BTL technical memorandum format. Arguments are TM 
number, (quoted list of) case number(s), and file number. Must precede other 
requests. 

Print in BTL technical report format; report number is x. Must be first. 

Begin table; if x is H table has repeated heading. | 

Underline argument (even in troff). 

‘UNIX’: first time used, add footnote ‘UNIX is a trademark of Beil Labora- 
tories.’ 

‘Bell Laboratories, Whippany, New Jersey 07981”. 
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terminals ~ conventional names 


DESCRIPTION 


These names are used by certain commands and are maintained as part of the shell environ- 
ment (see sh(1),environ(5)). 


Lear Seigler Adm-3a 

Hewlett-Packard HP262? series terminals 
Hewlett-Packard HP264? series terminals 
Human Designed Systems Concept 100 
Heathkit H19 

Microterm mime in enhanced ACT IV mode 
DIABLO 1620 (and others using HyType II) 
DASI/DTC/GSI 300 (and others using HyType 1) 
TELETYPE® Mode! 33 

TELETYPE Model 37 

TELETYPE Model 43 

Texas Instruments T1735 (and T1725) 

Texas Instruments T1745 

terminals with no special features 

Tektronix 4014 

Digital Equipment Corp. VT52 


The list goes on and on. Consult /etc/termcap (see termcap(5)) for an up-to-date and locally 


correct list. 


Commands whose behavior may depend on the terminal either consult TERM in the environ- 
ment, or accept arguments of the form —Tterm, where term is one of the names given above. 


SEE ALSO 


stty(1), tabs(1), plot(1), sh(1), environ(5) ex(1), clear(1), more(1), ul(1), tset(1), 
termcap(5), termlib(3), ttytype(5) 
troff(1) for nroff 


BUGS 


The programs that ought to adhere to this nomenclature do so only fitfully. 


. ert D mole aleane TR ms bn om 
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NAME 
ac — login accounting 


SYNOPSIS 
/etce/ac [ —-w wtmp] [ —p] [ —d] [ people ] ... 


DESCRIPTION 
Ac produces a printout giving connect time for each user who has logged in during the life of 
the current wrmp file. A total is also produced. —w is used to specify an alternate wrmp file. 
—p prints individual totals; without this option, only totals are printed. —d causes a printout 
for each midnight to midnight period. Any people will limit the printout to only the specified 
login names. If no wrmp file is given, /usr/adm/witmp is used. 


The accounting file /usr/adm/wimp is maintained by init and /ogin. Neither of these programs 
creates the file, so if it does not exist no connect-time accounting is done. To start accounting, 
it should be created with length 0. On the other hand if the file is left undisturbed it will grow 
without bound, so periodically any information desired should be collected and the file trun- 
cated. 


FILES 
/usr/adm/wtmp 


SEE ALSO 
init(8), sa(8), login(1), utmp(5). 
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NAME 
adduser — procedure for adding new users 


DESCRIPTION 
A new user must choose a login name, which must not already appear in /etc/passwd. An 
account can be added by editing a line into the passwd file; this must be done with the password 
file locked e.g. by using vipw(8). 


A new user is given a group and user id. User id’s should be distinct across a system, since 
they are used to control access to files. Typically, users working on similar projects will be put 
in the same group. Thus at UCB we have groups for system staff, faculty, graduate students, 
and a few special groups for large projects. System staff is group ‘‘10’’ for historical reasons, 


and the super-user is in this group. 
A skeletal account for a new user ‘‘ernie’’ would look like: 
ermie::235:20:& Kovacs, 508E, 7925 ,6428202:/mnt/grad/ernie:/bin/csh 


The first field is the login name ‘‘ernie’’. The next field is the encrypted password which is not 
given and must be initialized using passwd(1). The next two fields are the user and group id’s. 
Traditionally, users in group 20 are graduate students and have account names with numbers in 
the 200’s. The next field gives information about ernie’s real name, office and office phone and 
home phone. This information is used by the finger(1) program. From this information we 
can tell that ernie’s real name is ‘‘Ernie Kovacs’’ (the & here serves to repeat ‘‘ernie’’ with 
appropriate capitalization), that his office is 508 Evans Halli, his extension is x2-7925, and this 
his home phone number is 642-8202. You can modify the fnger(i) program if necessary to 
allow different information to be encoded in this field. The UCB version of finger knows 
several things particular to Berkeley — that phone extensions start ‘“°2—°’, that offices ending in 
‘**E’’ are in Evans Hall and that offices ending in “‘C’’ are in Cory Hall. 


The final two fields give a login directory and a login shell name. Traditionally, user files live 
on a file system which has the machines single letter ner(1) address as the first of two charac- 
ters. Thus on the Berkeley CS Department VAX, whose Berknet address is “‘csvax’’ abbrevi- 
ated ‘‘v’’ the user file systems are mounted on ‘‘/va’’, ‘‘/vb’’, etc. On each such filesystem 
there are subdirectories there for each group of users, i.e.: ‘‘/va/staff’’ and “‘/vb/prof’’. This is 
not strictly necessary but keeps the number of files in the top level directories reasonably small. 


The login shell will default to ‘‘/bin/sh” if none is given. Most users at Berkeley choose 
‘*/bin/csh”’ so this is usually specified here. 


It is useful to give new users some help in getting started, supplying them with a few skeletal 
files such as .profile if they use ‘‘/bin/sh’’, or .csArc and ./ogin if they use ‘“‘/bin/csh’’. The 
directory °“‘/usr/skel”’ contains skeletal definitions of such files. New users should be given 
copies of these files which, for instance, arrange to use ¢set(1) automatically at each login. 


FILES 

/etc/passwd password file 

/usr/skel skeletal login directory 
SEE ALSO 


passwd(1), finger(1), chsh(1), chfn(1), passwd(5), vipw(8) 


BUGS | 
User information should be stored in its own data base separate from the password file. 
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NAME 

analyze — Virtual UNIX postmortem crash analyzer 
SYNOPSIS 

/etc/analyze [ —s swapfile ] [—-f] [—-m][-—d][-—D] [—v] corefile [ system ] 
DESCRIPTION 


Analyze is the post-mortem analyzer for the state of the paging system. In order to use analyze 


you must arrange to get a image of the memory (and possibly the paging area) of the system 
after it crashes (see crash(8)). 


The analyze program reads the relevant system data structures from the core image file and 
indexing information from /ymunix (or the specified file). to determine the state of the pag- 
ing subsystem at the point of crash. It looks at each process in the system, and the resources 
each is using in an attempt to determine inconsistencies in the paging system state. Normally, 
the output consists of a sequence of lines showing each active process, its state (whether 
swapped in or not), its pObr, and the number and location of its page table pages. Any pages 
which are locked while raw i/o is in progress, or which are locked because they are /niransit are 


also printed. (Intransit text pages often diagnose as duplicated; you will have to weed these out 
by hand.) 


The program checks that any pages in core which are marked as not modified are, in fact, 
identical to the swap space copies. It also checks for non-overlap of the swap space, and that 
the core map entries correspond to the page tables. The state of the free list is also checked. 


Options to analyze: 

—D causes the diskmap for each process to be printed. 

—d causes the (sorted) paging area usage to be printed. 

— f which causes the free list to be dumped. 

—m _ causes the entire coremap State to be dumped. 

—y (long unused) which causes a hugely verbose output format to be used. 


In general, the output from this program can be confused by processes which were forking, 
swapping, or exiting or happened to be in unusual states when the crash occurred. You should 
examine the flags fields of relevant processes in the output of a pstat(8) to weed out such 
processes. 


It is possible to look at the core dump with adb if you do 


adb /vmunix /vmcore 
/m 80000000 Hfffefreyf 


which fixes the map of vmcore so that symbols in data space will work. Note that the debugger 
is looking at the physical memory at the point of crash; you will have to determine which pages 
of physical memory virtual pages are in if you wish to look at them. If analyze says that a 
processes page tables are in page 218 (hex of course), then you can look at them by looking al 
address 0x80043000 in the dump, i.e. ‘*80043000,80/X’’ will print the page of page tables. 


FILES 


/vmunix default system namelist 
SEE ALSO ; 

ps(1), crash(8), pstat(8) 
AUTHORS 


Ozalp Babaoglu and William Joy 
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DIAGNOSTICS 
Various diagnostics about overlaps in swap mappings, missing swap mappings, page table entries 
inconsistent with the core map, incore pages which are marked clean but differ from disk-image 
copies, pages which are locked or intransit, and inconsistencies in the free list. 


It would be nice if this program analyzed the system in general, rather than just the paging sys- 
tem in particular. | 
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NAME 

arcv — convert archives to new format 
SYNOPSIS 

/ete/arev file ... 
DESCRIPTION 


Arcy converts archive files (see ar(1), ar(5)) from 32v and Third Berkeley editions to a new 


portable format. The conversion is done in place, and the command refuses to alter a file not 
in old archive format. 


Old archives are marked with a magic number of 0177545 at the start; new archives have a first 
line ‘‘!<arch>”’. 


FILES 
/tmp/v*, temporary copy 


SEE ALSO 
ar(1), ar(5) 
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NAME 


arff, flcopy — archiver and copier for floppy 


SYNOPSIS 


/etc/arff [ key ] [name ... ] 
/etc/ficopy { —h] [ —tr] 


DESCRIPTION 


FILES 


Arff saves and restores files on the console floppy disk. Its actions are controlled by the key 
argument. The xey is a string of characters containing at most one function letter and possibly 
one or more function modifiers. Other arguments to the command are file names specifying 
which files are to be dumped or restored. 


Files names have restrictions. because of radix50 considerations. They must be in the form 1-6 
alphanumerics followed by ”.” followed by 0-3 alphanumerics. Case distinctions are lost. Only 
the trailing component of a pathname is used. 


The function portion of the key is specified by one of the following letters: 


r The named files are replaced where found on the floppy, or added taking up the 
minimal possible portion of the first empty spot on the floppy. 


x The named files are extracted from the floppy. 


The named files are deleted from the floppy. Arff will combine contiguous deleted 
files into one empty entry in the rt-11 directory. 


t The names of the specified files are listed each time they occur on the floppy. If no 
file argument is given, all of the names on the floppy are listed. 


The following characters may be used in addition to the letter which selects the function 
desired. 
Vv Normally arff does its work silently. The v (verbose) option causes it to type the 


name of each file it treats preceded by the function letter. With the t function, yv 
gives more information about the floppy entries than just the name. 


f causes arff to use the next argument as the name of the archive instead of 
/dev/floppy. 
m causes arff not to use the mapping algorithm employed in interleaving sectors 


around a floppy disk. In conjunction with the f option it may be used for extracting 
files from rtll formatted cartridge disks, for example. 


Flcopy copies the console floppy disk (opened as ‘/dev/floppy’) to a file created in the current 
directory, named “‘floppy’’, then prints the message ‘“‘Change Floppy, hit return when done’’. 
Then /lcopy copies the local file back out to the floppy disk. 


The —h option to flcopy causes it to open a file named ‘‘floppy’’ in the current directory and 
copy it to /dev/floppy;: the —t option causes only the first n tracks to participate in a copy. 


/dev/floppy 
floppy (in current directory) 


AUTHORS 


BUGS 


Keith Sklower, Richard Tuck 


Floppy errors are handled ungracefully; 4rfdoes not handle multi-segment rtl1 directories. 
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NAME 


bad144 — read/write dec standard 144 bad sector information 


SYNOPSIS 


bad144 disktype disk [sno [ bad... ] ] 


DESCRIPTION 


Badl44 can be used to inspect the information stored on a disk that is used by the disk drivers 


to implement bad sector forwarding. The format of the information is specified by DEC stan- 
dard 144, as follows. 


The bad sector information is located in the first 5 even numbered sectors of the last track of 


the disk pack. There are five identical copies of the information, described by the dkbad struc- 
ture. | 


Replacement sectors are allocated starting with the first sector before the bad sector information 
and working backwards towards the beginning of the disk. A maximum of 126 bad sectors are 


supported. The position of the bad sector in the bad sector table determines which replacement 
sector it corresponds to. 


The bad sector information and replacement sectors are conventionally only accessable through 
the ‘‘c’’ file system partition of the disk. If that partition is used for a file system, the user is 
responsible for making sure that it does not overlap the bad sector information or any replace- 
ment sectors. 

The bad sector structure is as follows: 


struct dkbad { 


long bt_csn; /* cartridge serial number ¢/ 
u_short bt_mbz; /* unused; should be 0 «/ 
u_short bt_flag; /* -| => alignment cartridge */ 
struct bt_bad [ 
u_short bt_cyl; /* cylinder number of bad sector */ 
u_short bt_trksec; /* track and sector number */ 


| ) bt_bad{126]; 


Unused slots in the bt_bad array are filled with all bits set, a putatively illegal value. 


Bad!144 is invoked by giving a device type (e.g. rk07, rm03, rm05, etc.), and a device name 
(e.g. hkO, hpl, etc.). It reads the first sector of the last track of the corresponding disk and 
prints out the bad sector information. It may also be invoked giving a serial number for the 
pack and a list of bad sectors, and will then write the supplied information onto the same loca- 
tion. Note, however, that bad/44 does not arrange for the specified sectors to be marked bad 
in this case. This option should only be used to restore known bad sector information which 
was destroyed. 


New bad sectors can be added by running the standard DEC formatter in section “‘bad’’. 


SEE ALSO 


BUGS 


badsect (8), format (8) 


It should be possible to both format disks on-line under UNIX and to change the bad sector 
information, marking new bad sectors, without running a standalone program. 


The bootstrap drivers used to boot the system do not understand bad sectors, handle ECC 
errors, or the special SSE (skip sector) errors of RM80 type disks. This means that none of 
these errors can occur when reading the file /vmunix to boot. When a disk drive is used to 
load the bootstrap code (the alternative would be that the bootstrap would be loaded from the 
console media), sector 0 of the disk drive and the file /boot in the root file system of that drive 


aye as 8-/ 
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must also not have any of these errors in it. 


The drivers which write a system core image on disk after a crash do not handle errors, thus 
the crash dump area must be free of errors and bad sectors. 
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NAME 


badsect — create files to contain bad sectors 


SYNOPSIS 


/etc/badsect sector ... 


DESCRIPTION 


Badsect makes a file to contain a bad sector. Normally, bad sectors are made inaccessible by the 
standard formatter, which provides a forwarding table for bad sectors to the driver, see 
bad! 44(8) for details. If a driver supports the bad blocking standard it is much preferable to 
use that method to isolate bad blocks, since the bad block forwarding makes the pack appear 
perfect, and such packs can then be copied with dd(8). The technique used by this program is 


also less general than bad block forwarding, as badsect can’t make amends for bad blocks in the 
i-list of file systems or in swap areas. 


Adding a sector which is suddenly bad to the bad sector table currently requires the running of 
the standard DEC formatter, as UNIX does not supply formatters. Thus to deal with a newly 


bad block or on disks where the drivers do not support the bad-blocking standard badsect may 
be used to good effect. 


Badsect is used on a quiet file system in the following way: First mount the file system, and 
change to its root directory. Make a directory BAD there and change into it. Run badsect giv- 
ing as argument all the bad sectors you wish to add. (The sector numbers should be relative to 
the beginning of the file systern, but this is not hard to do as the system reports relative sector 
numbers in its console error messages.) Then change back to the root directory, unmount the 
file system and run fsck(8) on the file system. The bad sectors should show up in two files or 
in the bad sector files and the free list. Have fsck remove files containing the offending bad 


sectors, but do not have it remove the BAD/a»nnnn files. This will leave the bad sectors in only 
the BAD files. 


Badsect works by giving the specified sector numbers in a mknod(2) system call, creating a reg- 
ular file whose first block address is the block containing bad sector and whose name is the bad 
sector number. The file has 0 length, but the check programs will still consider it to contain 
the block containing the sector. This has the pleasant effect that the sector is completely inac- 
cessible to the containing file system since it is not available by accessing the file. 


SEE ALSO 


BUGS 
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bad144(8), fsck (8) 


If both sectors which comprise a (1024 byte) disk block are bad, you should specify only one of 
them to badsect, as the blocks in the bad sector files actually cover both (bad) disk sectors. 
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NAME 

catman — create the cat files for the manual 
SYNOPSIS 

/etc/catman [—p] {[ —n ] { ~w] [ sections ] 
DESCRIPTION 


Catman creates the preformatted versions of the on-line manual from the nroff input files. 
Each manual page is examined and those whose preformatted versions are missing or out of 
date are recreated. If any changes are made, catman will recreate the /usr/lib/whatis database. 


If there is one parameter not starting with a ‘—’, it is take to be a list of manual sections to 
look in. For example 


catman 123 
will cause the updating to only happen to manual sections 1, 2, and 3. 
Options: 
—n prevents creations of /usr/lib/whatis. 
—p prints what would be done instead of doing it. 


~w _ causes only the /usr/lib/whatis database to be created. No manual reformatting is 


done. 
FILES 
/usr/man/man?/#.# raw (nroff input) manual sections 
/usr/man/cat?/*.# preformatted manual pages 
/usr/lib/makewhatis commands to make whatis database 
SEE ALSO 
man (1) 
BUGS 


Acts oddly on nights with full moons. 
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NAME 
chown, chgrp — cnange owner or group 


SYNOPSIS 
/etc/chown owner file ... 
/etc/chgrp group file ... 


DESCRIPTION 
Chown changes the owner of the files to owner. The owner may be either a decimal UID ora 
login name found in the password fle. 


Cherp changes the group-ID of the files to group. The group may be either a decimal GID ora 
group name found in the group-ID fle. 


Only the super-user can change owner or group, in order to simplify as yet unimplemented 
accounting procedures. 


FILES 
/etc/passwd 
/etc/group 


SEE ALSO 
chown(2), passwd(5), group(5) 
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NAME 
ciri — clear i-node 
SYNOPSIS 
/etce/clri filesystem i-number ... 


DESCRIPTION 
N.B.: Clri is obsoleted for normal file system repair work by /sck(8). 


Clri writes zeros on the t-nodes with the decimal i-numbers on the filesystem. After ciri, any 
blocks in the affected file will show up as ‘missing’ in an icheck(1) of the filesystem. 


Read and write permission is required on the specified file system device. The i-node becomes 
allocatable. 


The primary purpose of this routine is to remove a file which for some reason appears in no 
directory. If it is used to zap an i-node which does appear in a directory, care should be taken 
to track down the entry and rernove it. Otherwise, when the i-node is reallocated to some new 
file, the old entry will still point to that file. At that point removing the old entry will destroy 
the new file. The new entry will again point to an unallocated i-node, so the whole cycle is 
likely to be repeated again and again. 


SEE ALSO 
icheck (8) 


BUGS 
If the file is open, ciri is likely to be ineffective. 
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NAME 

config — Build system configuration files 
SYNOPSIS 

/ete/config con/ig_file 


DESCRIPTION 


Config builds a set of system configuration files from a short file which describes the sort of sys- 


tem that is being configured. It also takes as input a file which tells config what files are needed 
to generate a system. 


Config should be run from the conf subdirectory of the system source (usually /sys/conf or 
/ust/src/sys/conf). Config assumes that there is already a directory ../config_file created and it 
places all its output files in there. The output of config consists of a number files: ioconf.c which 
contains a description of what i/o devices are attached to the system, ubglue.s which is a set of 
interrupt service routines for devices attached to the UNIBUS, makefile for building the system 


and a set of header files which contain the number of various devices that will be compiled into 
the system. 


After running config, it is necessary to run "make depend” in the directory where the new 
makefile was created. Configreminds you of this when it completes. 


If you get any other error messages from config, you should fix the problems in your 
configuration file and try again. If you try to compile a system that had configuration errors, 
you will meet with failure. 


CONFIG FILE FORMAT 


In the following descriptions, a number can be a decimal integer, a whole octal number or a 
whole hexadecimal number. Hex and octal are specified to config in the same way they are 
specified to the C compiler, a number starting with "Ox" is a hex number and a number starting 


with just a "O" is an octal number. When specifying the timezone, you may also use floating 
point numbers. 


Comments are specified in a config file with the character "#". All characters from a "#" to the 
end of a line are ignored. — 


Lines beginning with tabs are considered continuations of the previous line. 


Lines of the config file can be one of several types. First there are lines which describe general 
things about your system. Here is a list of the possibilities. 


cpu " ype" 
This system is to run on the cpu type specified. More than one cpu type can appear in the 
config file. Legal types are VAX780, VAX750, and VAX7ZZ. 


options opilist 
Compile the listed options into the system. Options in this list are seperated by commas. 
There is a list of options that you may specify in the generic makefile. A line of the form 
"options FUNNY,HAHA’ yields ~- DFUNNY —DHAHA to the C compiler. 


timezone number [ dst ] 
Specifies the timezone you are in. This is measured in the number of hours west of GMT 
you are. 5 is EST, 8 is PST. If you specify dst, the system will operate under daylight 
savings time. 


ident name 
This system is to be known as name. This is usually a cute name like ERNIE (short for 
Ernie Co-Vax) or VAXWELL (for Vaxwell Smart). 


8-13 
AE am 4/1/38} 


CONFIG (8) UNIX Programmer’s Manual CONFIG (8) 


maxusers number 
The maximum expected number of simultaneously active user on this system is number. 
- This number is used to size several system data structures. 


config device sysname 
Generate a system which runs with its root on device and cali it sysname. There may be 
more than one con/ig specification in a config file. 


The second type of line in the config file describes what devices your system has and what they 
are connected to (e.g. I have a DZ-11 on UNIBUS Adapter 0). These lines have the following 
format. 

dey_typedev_name at con_dev more_info 


Dev_type is either raaster, tape, disk, controller device, or pseudo-device. A master is a 
MASSBUS tape controller. A controller is a disk controller, a UNIBUS tape controller, an mba 
(MASSBUS) or a uba (UNIBUS). A device is usually something which connects to the uba, 
like a DZ-11 or a DR-11. Disk and tape should be self-explanatory. A pseudo-device is some- 
thing which should be conditionally loaded, but is not really a device. Current examples are the 
bk line discipline, the pseudo-tty driver and various network subsystems. If you load a subsys- 
tem you will probably find it convenient to enable conditionaly code using a options 
specification. 


The dev_name is the name of the device you are specifying. If it is not a pseudo-device, you 
must give a number afterwards (e.g. dz0, dz1, hp0). 


Con_dev is what the device you are specifying is connected to. If you have a disk on MASSBUS 
adapter zero then the proper con_devis mbaQ. For MASSBUS and UNIBUS adapters, you must 
give nexus? as the con_deyv. 


The more_info field is a sequence of the following: 


esr addr | 
Specifies the csr for a device. Must be given for UNIBUS tape and disk controllers and all 
devices connected to the UNIBUS. Make certain that you put a leading zero on the 
address so that it will be interpreted as an octal number. 


drive number 
For a disk or UNIBUS tape, specifies which drive this is. 


slave number 
For a MASSBUS tape, specifies which tape slave it is. 


flags number 
These flags are passed to the device driver at system initialization time. 


vector addr [ addr / 
For devices which interrupt on the UNIBUS, specifies the interrupt service routine. 


The easiest way to understand config files it to look at a working one and modify it to suit your 
system. Here is a short sample configuration file for a system with an RMQ3, a TU45, a DZ-11 


and a DH-11. 
oe 
# Sample configuration file 
# 
cpu VAX730 
ident SAMPLE 
hz 60 
timezone 8 dst 
maxusers 24 
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config hp vmunix 

config rk rkvmunix 
controller mba0 at nexus ? 
controller uba0 at nexus ? 

disk hp0Q at mba0O drive 0 
master htO at mbal drive 0 
tape tud at htO slave 0 


pseudo-device pty 
pseudo-device bk 


controller hkO at ubaO csr 0177440 vector rkintr 

disk rkO at hkO drive 0 

disk rkl at hkO drive 1 

device dhl at uba0 csr 0160040 vector dhrint dhxint 
device dz0 at ubaO csr 0160100 flags OxcO vector dzrint dzxint 


A ? may be substituted for a number in two places and the system will figure out what to fill in 
for the ? when it boots. You can put question marks on a con_dev (e.g. at mba?) or on a drive 
number (e.g. drive 7). This allows redundancy as a single system can be built which will reboot 
on different hardware configurations. 


FILES 

/sys/conf/makefile Generic makefile 

/sys/conf/ files List of files system is built from 
SEE ALSO 

The SYNOPSIS portion of each device in section 4. 
AUTHOR 

Michae! Toy 
BUGS 


The line numbers reported in error messages are usually off by one. 


Should describe the format of the ‘‘files’’ file here; you can probably figure it out for yourself 
in the meantime. | 


No exhaustive testing of responses to all the weird input semantic errors possible has been 
done. 
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NAME 
crash ~ what happens when the system crashes 


DESCRIPTION 
This section explains what happens when the system crashes and how you can analyze crash 
dumps. 


When the system crashes voluntarily it prints a message of the form 
panic: why i gave up the ghost 


on the console, takes a dump on a mass Storage peripheral, and then invokes an automatic 
reboot procedure as described in reboor(8). (If auto-reboot is disabled on the front panel of the 
machine the system will simply halt at this point.) Unless some unexpected inconsistency is 
encountered in the state of the file systems due to hardware or software failure the system will 
then resume multi-user operations. 


The system has a large number of internal consistency checks; if one of these fails, then it will 
panic with a very short message indicating which one failed. 


The most common cause of system failures is hardware failure, which can reflect itseif in 
different ways. Here are the messages which you are likely to encounter, with some hints as to > 
causes. Left unstated in all cases is the possibility that hardware or software error produced the 
message in some unexpected way. | 


IO err in push 

hard IO err in swap 
The system encountered an error trying to write to the paging device or an error in 
reading critical information from a disk drive. You should fix your disk if it is broken 
or unreliable. 


timeout table overflow 
This really shouldn’t be a panic, but until we fix up the data structure involved, run- 
ning out of entries causes a crash. If this happens, you should make the timeout table 
bigger. 


KSP not valid 

SBI fault 

CHM? in kerne! 
These indicate either a serious bug in the system or, more often, a glitch or failing 
hardware. If SBI faults recur, check out the hardware or call field service. If the other 
faults recur, there is likely a bug somewhere in the system, although these can be 
caused by a flakey processor. Run processor microdiagnostics. 


machine check %x: description 
machine dependent machine-check information 
We should describe machine checks, and will someday. For now, ask someone who 
knows (like your friendly field service peopie). 


trap type %d, code ™=%d, pc == 4x 
A unexpected trap has occurred within the system; the trap types are: 


reserved addressing fault 
privileged instruction fault 
reserved operand fault 
bpt instruction fault 

xfc instruction fault 
system Cail trap 

arithmetic trap 

ast delivery trap 
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8 segmentation fault 

9 protection fault 

10 trace trap 

11 compatibility mode fault 


12 page fault 
13 page table fault 


The favorite trap type in system crashes is trap type 9, indicating a wild reference. The code is 
the referenced address, and the pc at the time of the fault is printed. These problems tend to 
be easy to track down if they are kernel bugs since the processor stops cold, but random flaki- 
ness seems to cause this sometimes, e.g. we have trapped with code 80000800 three times in 
six months as an instruction fetch went across this page boundary in the kernel but have been 
unable to find any reason for this to have happened. 
init died 
The system initialization process has exited. This is bad news, as no new users will 
then be able to log in. Rebooting is the only fix, so the system just does it right away. 


That completes the list of panic types you are likely to see. 


When the system crashes it write (or at least attempts to write) a image of the current memory 
into the back end of the primary swap area. After the system is rebooted, the program 
savecore(8) runs and preserves a copy of this core image and the current system in a specified 
directory for later perusal. See savecore(8) for details. 


To analyze a dump you should begin by running ps —alxck to print the process table at the time 
of the crash. Use adb(1) to examine Amcore. The location _rpb+01508 is the bottom of a 
stack onto which were pushed the stack pointer sp, PCBB (containing the physical address of a 
u_area), MAPEN, IPL, and registers r13—r0 (in that order). r13(fp) is the system frame 
pointer and the stack is used in standard calls format. Use adb(1) to get a reverse calling 
order. In most cases this procedure will give an idea of what is wrong. A more complete dis- 
cussion of system debugging is impossible here. See, however, analyze(8) for some more 
hints. 


SEE ALSO 
analyze(8), reboot (8) 
VAX 11/780 System Maintenance Guide for more information about machine checks. 
BUGS 
There should be a better program than analyze(8) available which prints out more of the system 
state symbolically after a crash to lessen the tedious tasks involved in crash analysis. 


4th Rerkelev Distribution Q/1/81 


CRON (8) UNIX Programmer’s Manual CRON (8) ° 


NAME 
cron — clock daemon 


SYNOPSIS 
/ete/cron 


DESCRIPTION 
Cron executes commands at specified dates and times according to the instructions in the file 
/usr/lib/crontab. Since cron never exits, it should only be executed once. This ts best done by 
running cron from the initialization process through the file /etc/rc; see init(8). 


Crontab consists of lines of six fields each. The fields are separated by spaces or tabs. The first 
five are integer patterns to specify the minute (0-59), hour (0-23), day of the month (1-31), 
month of the year (1-12), and day of the week (1-7 with 1=Monday). Each of these patterns 
may contain a number in the range above; two numbers separated by a minus meaning a range 
inclusive; a list of numbers separated by commas meaning any of the numbers; or an asterisk 
meaning all legal values. The sixth field is a string that is executed by the Shell at the specified 
times. A percent character in this field is translated to a new-line character. Only the first line 
(up to a % or end of line) of the command field is executed by the Shell. The other lines are 
made available to the command as standard input. 


Crontab is examined by cron every minute. 


FILES 
/usr/lib/crontab 
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NAME 

dcheck — file system directory consistency check 
SYNOPSIS | 

/etc/dcheck {[ —i numbers ] [ filesystem ] 
DESCRIPTION 


N.B.: Dcheck is obsoleted for normal consistency checking by /sck(8). 


Dcheck reads the directories in a file system and compares the link-count in each i-node with 
the number of directory entries by which it is referenced. If the file system is not specified, a 
set of default file systems is checked. 


The -i flag is followed by a list of i-numbers; when one of those i-numbers turns up in a 
directory, the number, the i-number of the directory, and the name of the entry are reported. 
The program is fastest if the raw version of the special file is used, since the i-list is read in 
large chunks. 


FILES , 
Default file systems vary with installation. 


SEE ALSO 
fsck(8), icheck(8), filsys(5), clri(8), ncheck (8) 


DIAGNOSTICS 
When a file turns up for which the link-count and the number of directory entries disagree, the 
relevant facts are reported. Allocated files which have 0 link-count and no entries are also 
listed. The only dangerous situation occurs when there are more entries than links; if entries 
are removed, so the link-count drops to 0, the remaining entries point to thin air. They should 
be removed. When there are more links than entries, or there is an allocated file with neither 
links nor entries, some disk space may be lost but the situation will not degenerate. 


BUGS 


Since dcheck is inherently two-pass in nature, extraneous diagnostics may be produced if applied 
to active file systems. 


Decheck is obsoleted by /sck and remains for historical reasons. 
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NAME 
delivermail — deliver mail to arbitrary people 

SYNOPSIS 
/ete/delivermail [ —[fr] address} [ —a] [~—ex] [—n] [—m] [—s] [—-i] [-—h NV] 
address ... 

DESCRIPTION 


Delivermail delivers a letter to one or more people, routing the letter over whatever networks 
are necessary. Delivermail will do inter-net forwarding as necessary to deliver the mail to the 
correct place. 


Delivermail is not intended as a user interface routine; it is expected that other programs will 
provide user-friendly front ends, and delivermail will be used only to deliver pre-formatted mes- 
sages. 


Delivermail reads its standard input up to a control-D or a line with a single dot and sends a 
copy of the letter found there to all of the addresses listed. If the —i flag is given, single dots 
are ignored. It determines the network to use based on the syntax of the addresses. Addresses 
containing the character ‘@’ or the word “‘at’’ are sent to the ARPANET; addresses containing 
‘!? are sent to the UUCP net, and addresses containing ‘:’ or *.’ are sent to the Berkeley net- 
work. Other addresses are assumed to be local. 


Local addresses are looked up in a file constructed by sewaliases(1) from the data file 
lusrilib/aliases and aliased appropriately. Aliasing can be prevented by preceding the address 
with a backslash or using the —n flag. Normally the sender is not included in any alias expan- 
sions, e.g., if ‘john’ sends to ‘group’, and ‘group’ includes ‘john’ in the expansion, then the 
letter will not be delivered to ‘john’. The -~m flag disables this suppression. 


Delivermail computes the person sending the mail by looking at your login name. The ‘‘from’’ 
person can be explicitly specified by using the -~f flag; or, if the —a flag is given, delivermail 
looks in the body of the message for a ‘‘From:’’ or ‘‘Sender:’” field in ARPANET format. The 
~—f and —a flags can be used only by the special users root and network, or if the person you are 
trying to become is the same as the person you are. The ~—r flag is entirely equivalent to the 
—f flag; it ts provided for ease of interface only. 


The ex flag controls the disposition of error output, as follows: 


e Print errors on the standard output, and echo a copy of the message when done. It is 
assumed that a network server will return the message back to the user. 


| Mail errors back to the user. 
Print errors on the standard output. 


Throw errors away; only exit status is returned. 


gq 2 U0 3 


Write errors back to the user’s terminal, but only if the user is still logged in and write per- 
mission is enabled; otherwise errors are mailed back. 


If the error is not mailed back, and if the mail originated on the machine where the error 
occurred, the letter is appended to the file dead. letter in the sender’s home directory. 


If the first character of the user name is a vertical bar, the rest of the user name ts used as the 
name of a program to pipe the mail to. It may be necessary to quote the name of the user to 
keep delivermail from suppressing the blanks from between arguments. 


The message is normally edited to eliminate ‘‘From”’ lines that might confuse other mailers. In 
particular, “‘From’’ lines in the header are deleted, and ‘“‘From”’ lines in the body are 
prepended by ‘>’. The -s flag saves ‘*‘From”’ lines in the header. 
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The -h flag gives a ‘“‘hop-count’’, i.e., a measure of how many times this message has been 
processed by delivermail (presumably on different machines). Each time delivermail processes a 
message, it increases the hop-count by one; if it exceeds 30 delivermail assumes that an alias 
loop has occurred and it aborts the message. The hop-count defaults to zero. 


Detivermail returns an exit status describing what it did. The codes are defined in <sysexits.h> 


EX OK Successful completion on all addresses. 
EX NOUSER User name not recognized. 
EX UNAVAILABLE  Catchall meaning necessary resources were not available. 
EX SYNTAX Syntax error in address. 
EX SOFTWARE Internal software error, including bad arguments. 
EX OSERR Temporary operating system error, such as ‘‘cannot fork’’. 
EX_NOHOST Host name not recognized. 
FILES 
/usr/lib/aliases raw data for alias names 
/usr/lib/aliases.dir data base of alias names 
/usr/lib/aliases. pag 
/bin/mail to deliver uucp mail 
/usr/net/bin/v6mail to deliver local mail 
/usr/net/bin/sendmai! to deliver Berknet mail 
/usr/lib/mailers/arpa to deliver ARPANET mail 
/tmp/maile temp file 
/tmp/xscript saved transcript 
SEE ALSO 


BUGS 


biff(1), binmail(1), mail(1), newaliases(1), aliases(S) 


Delivermail sends one copy of the letter to each user; it should send one copy of the letter to 
each host and distribute to multiple users there whenever possible. 


Delivermail assumes the addresses can be represented as one word. This is incorrect according 
to the ARPANET mail protocol RFC 733 (NIC 41952), but is consistent with the real world. 
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NAME 


dmesg — collect system diagnostic messages to form error log 


SYNOPSIS 


/etc/dmesg [ — ] 


DESCRIPTION 


FILES 


BUGS 


Dmesg looks in a system buffer for recently printed diagnostic messages and prints them on the 
standard output. The messages are those printed by the system when device (hardware) errors 
occur and (occasionally) when system tables overflow non-fatally. If the — flag is given, then 
dmesg computes (incrementally) the new messages since the last time it was run and places 
these on the standard output. This is typically used with cron(8) to produce the error log 
/usriadm/imessages by running the command 


/etc/dmesg — >> /usr/adm/messages 


every 10 minutes. 


/usr/adm/messages error log (conventional location) 
/usr/adm/msgbuf scratch file for memory of — option 


The system error message buffer is of small finite size. As dmesg is run only every few 
minutes, not all error messages are guaranteed to be logged. This can be construed as a biess- 
ing rather than a curse. 


Error diagnostics generated immediately before a system crash will never get logged. 
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NAME 

dump — incremental file system dump 
SYNOPSIS 

/etc/dump [ key [ argument... ] filesystem ] 
DESCRIPTION 


Dump copies to magnetic tape all files changed after a certain date in the filesystem. The key 


specifies the date and other options about the dump. Key consists of characters from the set 
0123456789fuJsdWn. 


0-9 This number is the ‘dump level’. All files modified since the last date stored in the file 
/etc/dumpdates for the same filesystem at lesser levels will be dumped. If no date is deter- 


mined by the level, the beginning of time is assumed; thus the option 0 causes the entire 
filesystem to be dumped. 


f Place the dump on the next argument file instead of the tape. 


u If the dump completes successfully, write the date of the beginning of the dump on file 
/etc/dumpdates. This file records a separate date for each filesystem and each dump level. 
The format of /etc/dumpdates is readable by people, consisting of one free format record 
per line: filesystem name, increment level and crime(3) format dump date. /etc/dumpdates 
may be edited to change any of the fields, if necessary. Note that /erc/dumpdates is in a 
format different from that which previous versions of dump maintained in /etc/ddate, 
although the information content is identical. 


J This option is intended to be invoked only when the old format /etc/ddate files are updated 
to the new format /erc/dumpdates format. The effect of this option is to convert between 
the old, obsolete format and to the new format. If the J option is invoked, all other 
options are ignored, and dump terminates immediately. 


S The size of the dump tape is specified in feet. The number of feet is taken from the next 
argument. When the specified size is reached, dump will wait for reels to be changed. The 
default tape size is 2300 feet. 


d The density of the tape, expressed in BPI, is taken from the next argument. This is used 
in calculating the amount of tape used per reel. The default is 1600. 


W  Dumptells the operator what file systems need to be dumped. This information is gleaned 
from the files /etc/dumpdates and /etc/fstab. The W option causes dump to print out, for 
each file system in /etc/dumpdates the most recent dump date and level, and highlights 
those file systems that should be dumped. If the W option is set, all other options are 
ignored, and dump exits immediately. 


w Is like W, but prints only those filesystems which need to be dumped. 


n Whenever dump requires operator attention, notify by means similar to a wall(1) all of the 
operators in the group ‘‘operator’’. 


If no arguments are given, the key is assumed to be 9u and a default file system is dumped to 
the default tape. 


Dump requires operator intervention on these conditions: end of tape, end of dump, tape write 
error, tape open error or disk read error (if there are more than a threshold of 32). In addition 
to alerting all operators implied by the mn key, dump interacts with the operator on dump's con- 
trol terminal at times when dumpcan no longer proceed, ot if something is grossly wrong. All 
questions dump poses must be answered by typing ‘‘yes’’ or ° ‘no’’, appropriately. 


Since making a dump involves a lot of time and effort for full dumps, dump checkpoints itself 
at the start of each tape volume. If writing that volume fails for some reason, dump will, with 
operator permission, restart itself from the checkpoint after the old tape has been rewound and 
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removed, and a new tape has been mounted. 


Dump telis the operator what is going on at periodic intervals, including usually low estimates of 
the number of blocks to write, the number of tapes it will take, the time to completion, and the 
time to the tape change. The output is verbose, so that others know that the terminal control- 


ling dump is busy, and will be for some time. 


Now a short suggestion on how to perform dumps. Start with a full level O dump 
dump Oun 


Next, dumps of active file systems are taken on a daily basis, using a modified Tower of Hanoi 
algorithm, with this sequence of dump levels: 

3254769899... 
For the daily dumps, a set of 10 tapes per dumped file systeni is used on a cyclical basis. Each 
week, a level 1 dump is taken, and the daily Hanoi sequence repeats with 3. For weekly 
dumps, a set of 5 tapes per dumped file system is used, also on a cyclical basis. Each month, a 
level 0 dump is taken on a set of fresh tapes that is saved forever. 


FILES 
/dev/trplg default filesystem to dump from 
/dev/rmt8 default tape unit to dump to 
/etc/ddate old format dump date record (obsolete after —J option) 
/etc/dumpdates new format dump date record 
/etc/fstab Dump table: file systems and frequency 
/etc/group to find group operator 
SEE ALSO 
restor(1), dump(5), dumpdir(1), fstab(S) 
DIAGNOSTICS 


Many, and verbose. 


BUGS : 
Sizes are based on 1600 BPI blocked tape; the raw magtape device has to be used to approach 
these densities. Fewer than 32 read errors on the Alesystem are ignored. Each reel requires a 
new process, so parent processes for reels already written just hang around until the entire tape 


iS written. 


It would be nice if dump knew about the dump sequence, kept track of the tapes scribbied on, 
told the operator which tape to mount when, and provided more assistance for the operator 
running restor. 
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NAME 

dumpdir — print the names of files on a dump tape 
SYNOPSIS 

/etc/dumpdir [ f filename ] 
DESCRIPTION 


Dumpdir is used to read magtapes dumped with the dump command and list the names and 
inode numbers of all the files and directories on the tape. 


The f option causes filename as the name of the tape instead of the default. 


FILES 
default tape unit vanes with installation 
rst* 


SEE ALSO 
dump(]1), restor(1) 

DIAGNOSTICS 
If the dump extends over more than one tape, it may ask you to change tapes. Reply with a 
new-line when the next tape has been mounted. 

BUGS 


There is redundant information on the tape that could be used in case of tape reading problems. 
Unfortunately, dumpdir doesn’t use it. 
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NAME 
format — how to format disks 


DESCRIPTION 
Warning: These instructions are for pe 
for 11/750 cpus (yet at lez 
how. 


ople with 11/780 CPU’s. We don’t know how to do this 
ast), you'll have to figure it out yourself; if you do call us and tell us 


The formatting procedures are different for each type of disk. Listed here are the formatting 
procedures for RKO7’s, RPOX, RMOX and Emulex Unibus Disks. 


You should shut down UNIX and halt the machine to do any disk formatting. Make certain 
you put in the pack you want formatted. It is also a good idea to spin down or write protect the 
disks you don’t want to format, just in case. 


Formatting a RKO7. Load the floppy labled, "RX11 VAX DSK LD DEV #1" in the floppy disk 

drive, and ioe the following commands: 
DIAGNOSTIC SUPERVISOR. ZZ-E 
DS>ATTACH DW780 SBI DWO 3 § 
DS> ATTACH RKO7 DW0O DMAO 
DS>LOAD EVRAC 
DS>START/SEC:PACKINIT 


Formatting a RPOX. Follow the above procedures except that the ATTACH and SELECT lines 
should read. 


SSAA-X5.0-119 23-JAN-1980 12:44:40.03 


DS> ATTACH RH 085 
DS> ATTACH RPOX | : AQ RPOX is, e.g. RPO6) 
DS>SELECT 


This is for drive 0 on mbaQ: use 9 instead of 8 for mbal, etc. 


Formatting a RMOX. Follow the above procedures except that the ATTACH and SELECT 
lines should read. 

DS>ATTACH RH780 SBI RHO 8 5 

DS> eee nen RHO DRAO 


> > >SET REL:2013FDCO0 
> >>SET DEF WORD 

> > >SET DEF 0C1 
>>>SET DEF PHYS 
>>>U 

>>>! 

>>>D/P 100 

>>>D/P 0 2} 

>>>D/P 36 177777 
>>>D/P 077 

(figure out when it is done) 
> >>SET REL:O 

>> >SET DEF LONG 
>> >SET DEF HEX 


Once a disk is formatted, you'll still have to build file systems on it with mkfs(8) before you 


can use it with UNIX. 
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Don’t forget to put your UNIX console floppy back in the floppy disk drive. 


SEE ALSO | 
bad144(8), badsect(8), mkfs(8) 
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NAME | 
fsck — file system consistency check and interactive repair 


SYNOPSIS 
/etc/fsck —p [ filesystem ... ] 
/etce/fsck [ ~y] [ ~m] [ ~sX ] [ ~SX ] [ —t filename ] [ filesystem ] ... 


DESCRIPTION 

The first form of /sck preens a standard set of filesystems or the specified file systems. It is 
normally used in the script /etc/re during automatic reboot. In this case /sck reads the table 
/etc/fstab to determine which file systems to check. It uses the information there to inspect 
groups of disks in paralle! taking maximum advantage of i/o overlap to check the file systems as 
quickly as possible. Normally, the root file system will be checked on pass 1, other ‘‘root’’ 
(‘‘a’’ partition) file systems on pass 2, other small file systems on separate passes (e.g. the ‘‘d”’ 
file systems on pass 3 and the ‘‘e”’ file systems on pass 4), and finally the large user file systems 
on the last pass, e.g. pass 5. A pass number of 0 in fstab causes a disk to not be checked: simi- 
larly partitions which are not shown as to be mounted ‘‘rw’’ or “‘ro””’ are not checked. 


The system takes care that only a restricted class of innocuous inconsistencies can happen 
unless hardware or software failures intervene. These are limited to the following: 


Unreferenced inodes 

Link counts in inodes too large 
Missing blocks in the free list 
Blocks in the free list also in files 
Counts in the super-biock wrong 


These are the only inconsistencies which fsck with the —p option will correct, if it encounters 
other inconsistencies, it exits with an abnormal return status and an automatic reboot will then 
fail. For each corrected inconsistency one or more lines will be printed identifying the file sys- 
tem on which the correction will take place, and the nature of the correction. After success- 
fully correcting a file system, /sck will print the mumber of files on that file system and the 
number of used and free blocks. 


Without the —p option, fsck audits and interactively repairs inconsistent conditions for file sys- 
tems. If the file system is inconsistent the operator is prompted for concurrence before each 
correction is attempted. It should be noted that a number of the corrective actions which are 
not fixable under the —p option will result in some loss of data. The amount and severity of 
data lost may be determined from the diagnostic output. The default action for each con- 
sistency correction is to wait for the operator to respond yes or no. If the operator does not 
have write permission /sck will default to a — 1m action. | 


Fsck has more consistency checks than its predecessors check, dcheck, fcheck, and icheck com- 
bined. 


The following flags are interpreted by fsck. 


~y Assume a yes response to all questions asked by /sck; this should be used with great cau- 
tion as this is a free license to continue after essentially unlimited trouble has been 
encountered. 


— Assume a no response to all questions asked by /sck; do not open the file system for 
writing. 

~sX Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the 
super-block of the file system. The file system should be unmounted while this is done; 


if this is not possible, care should be taken that the system is quiescent and that it is 
rebooted immediately afterwards. This precaution is necessary so that the old, bad, in- 
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FILES 


core copy of the superblock will not continue to be used, or written on the file system. 


The —sJZ option allows for creating an optimal free-list organization. The following 
forms of X are supported for the following devices: 


—s3 (RPO3) 
—s54 (RP04, RPOS, RP0O6) 
— sBlocks-per-cylinder :Blocks-to-skip (for anything else) 


If X is not given, the values used when the filesystem was created are used. If these 
values were not specified, then the value 400:9is used. 


-SX Conditionally reconstruct the free list. This option is like —sX above except that the free 
list is rebuilt only if there were no discrepancies discovered in the file system. Using —S 
will force a no response to all questions asked by /sck. This option is useful for forcing 
free list reorganization on uncontaminated file systems. 


-—t If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If the —t 
option is specified, the file named in the next argument is used as the scratch file, if 
needed. Without the —t flag, /sck will prompt the operator for the name of the scratch 
file. The file chosen should not be on the filesystem being checked, and if it is not a spe- 
cial file or did not already exist, it is removed when fsck completes. 


If no filesystems are given to fsck then a default list of file systems is read from the file 
/etc/fstab. 


Inconsistencies checked are as follows: 


l Blocks claimed by more than one inode or the free list. 

2 Blocks claimed by an inode or the free list outside the range of the file system. 
5. Incorrect link counts. 

4 Size checks: 


Directory size not 16-byte aligned. 
> Bad inode format. 
6. Blocks not accounted for anywhere. 
7 Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 
8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file system. 
9. Bad free block list format. , 
10. Total free block and/or free inode count incorrect. 


Orphaned files and directories (allocated but unreferenced) are, with the operator's con- 
currence, reconnected by placing them in the lost+ found directory. The name assigned is the 
inode number. The only restriction is that the directory lost + found must preexist in the root of 
the filesystem being checked and must have empty siots in which entries can be made. This is 
accomplished by making lost+found, copying a number of files to the directory, and then 
removing them (before fsck is executed). 


Checking the raw device is almost always faster. 


/etc/fstab contains default list of file systems to check. 


DIAGNOSTICS 


4th Berkeley Distribution 


The diagnostics produced by /sck are intended to be self-explanatory. 
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SEE ALSO 
fstab(5), fs(5), crash(8), reboot(8) 


BUGS 


Inode numbers for . and .. in each directory should be checked for validity. 


—g and —b options from check should be availabie in fsck. 
There should be some way to start a fsck —p at pass n 
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NAME 


getty — set terminal mode 


SYNOPSIS 


/ete/getty [ char ] 


DESCRIPTION 


Getty is invoked by init(8) immediately after a terminal is opened, following the making of a 


connection. While reading the name gerty attempts to adapt the systern to the speed and type of 
terminal being used. 


Init calls getty with an argument specified by the ttys file entry for the terminal line. Arguments 
other than ‘0° can be used to make gerty treat the line specially. Normally, it sets the speed of 
the interface to 300 baud, specifies that raw mode is to be used (break on every character), that 
echo is to be suppressed, and either parity allowed. It types a banner identifying the system 
(from /usr/include/ident.h and the ‘login:’ message. Then the user’s name is read, a character 
at atime. If a null character is received, it is assumed to be the result of the user pushing the 
‘break’ (‘interrupt’) key. The speed is then changed to 1200 baud and the ‘login:’ is typed 
again; a second ‘break’ changes the speed to 150 baud and the ‘login: is typed again. Succes- 
sive ‘break’ characters cycle through the speeds 300, 1200, and 150 baud. 


The user’s name is terminated by a new-line or carriage-return character. The latter results in 
the system being set to treat carriage returns appropriately (see srry(2)). 7 


The user's name is scanned to see if it contains any lower-case alphabetic characters; if not, and 
if the name is nonempty, the system is told to map any future upper-case characters into the 
corresponding lower-case characters. 


Finally, login is called with the user’s name as argument. 


SEE ALSO 


BUGS 


init(8), login(1), stty(2), ttys(S) 
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NAME 

halt — stop the processor 
SYNOPSIS 

/ete/halt [ ~n] [ —q] [ -y] 
DESCRIPTION 


Halt writes out sandbagged information to the disks and then stops the processor. The machine 
does not reboot, even if the auto-reboot switch is set on the console. 


The —n option prevents the sync before stopping. The —q option causes a quick halt, no 
graceful shutdown is attempted. The ~—y option is needed if you are trying to halt the system 
from a dialup. 


SEE ALSO 
reboot(8), shutdown (3) 


BUGS 
It is very difficult to halt a VAX, as the machine wants to then reboot itself. A rather tight 
loop suffices. 
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NAME 

icheck — file system storage consistency check 
SYNOPSIS 

/etc/icheck [ —s] [ —b numbers ] [ filesystem ] 
DESCRIPTION 


N.B.: [check is obsoleted for normal consistency checking by /sck(8). 


[check examines a file system, builds a bit map of used blocks, and compares this bit map 
against the free list maintained on the file system. If the file system is not specified, a set of 
default file systems is checked. The normal output of icheck includes a report of 


The total number of files and the numbers of regular, directory, block special and char- 
acter special files. 


The total number of blocks in use and the numbers of single-, double-, and triple- 
indirect blocks and directory blocks. 


The number of free blocks. 
The number of blocks missing; i.e. Not in any file nor in the free list. 


The —s option causes icheck to ignore the actual free list and reconstruct a new one by rewrit- 
ing the super-block of the file system. The file system should be dismounted while this ts 
done; if this is not possible (for example if the root file system has to be salvaged) care should 
be taken that the system is quiescent and that it is rebooted immediately afterwards so that the 
old, bad in-core copy of the super-block will not continue to be used. Notice also that the 
words in the super-block which indicate the size of the free list and of the i-list are believed. If 
the super-block has been curdled these words will have to be patched. The —s option causes - 
the normal output reports to be suppressed. 


Following the —b option is a list of block numbers; whenever any of the named blocks turns 
up in a file, a diagnostic is produced. 


Icheck is faster if the raw version of the special file is used, since it reads the i-list many blocks 
at a time. ; 

FILES 
Default file systems vary with installation. 

SEE ALSO | 
fsck(8), dcheck(8), ncheck(8), filsys(5), clri(8) 

DIAGNOSTICS 
For duplicate blocks and bad blocks (which lie outside the file system) icheck announces the 
difficulty, the i-number, and the kind of block involved. If a read error is encountered, the 
block number of the bad block is printed and icheck considers it to contain 0. ‘Bad freeblock’ 
means that a block number outside the available space was encountered in the free list. ‘n dups 
in free’ means that ” blocks were found in the free list which duplicate blocks either in some 
file or in the earlier part of the free list. 

BUGS | . 
Since icheck is inherently two-pass in nature, extraneous diagnostics may be produced if applied 
to active file systems. 

It believes even preposterous super-blocks and consequently can get core images. 


The system should be fixed so that the reboot after fixing the root file system is not necessary. 
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NAME 
init — process control initialization 


SYNOPSIS 
/etc/init 


DESCRIPTION 

Init is invoked inside UNIX as the last step in the boot procedure. It normally then runs the 
automatic reboot sequence as described in reboor(8), and if this succeeds, begins multi-user 
operation. If the reboot fails, it commences single user operation by giving the super-user a 
shell on the console. It is possible to pass parameters from the boot program to initso that sin- 
gle user operation is commenced immediately. When such single user operation is terminated 
by killing the single-user shell (i.e. by hitting “D), initruns /etc/rc without the reboot parameter. 
This command file performs housekeeping operations such as removing temporary files, mount- 
ing file systems, and starting daemons. 


In multi-user operation, init’s role is to create a process for each terminal port on which a user 
may log in. To begin such operations, it reads the file /etc/tys and forks several times to create 
a process for each terminal specified a the file. Each of these processes opens the plete 
terminal for reading and writing. These channels thus receive file descriptors 0, 1 and 2, 
standard input and output and the diagnostic output. Opening the terminal will usually Sak 
a delay, since the open is not completed until someone is dialed up and carrier established on 
the channel. If a terrninal exists but an error occurs when trying to open the terminal initcom- 
plains by writing a message to the system console, the message is repeated every 10 minutes for 
each such terminal until the terminal is shut off in /etc/ ttys and init notified (by a hangup, as 
described below), or the terminal becomes accessible (init checks again every minute). After 
an open succeeds, /efc/gerty is called with aepumeni as specified by the second character of the 
ttys file line. Gerry reads the user’s name and invokes Jogin to log in the user and execute the 
Shell. 


Ultimately the Shell will terminate b« 


ecause of an end-of-file either typed explicitly or generated 
as a result of hanging up. The main path of init, which has been waiting for such an event, 
wakes up and removes the appropriate entry from the file uwsmp, which records current users, 
and makes an entry in /usr/adm/wimp, which maintains a history of logins and logouts. The 
wimp entry is made only if a user logged in successfully on the line. Then the appropriate ter- 


minal is reopened and gery is reinvoked. 


Init catches the hangup signal (signal SIGHUP) and interprets it to mean that the file /erc/trys 
should be read again. The Shell process on each line which used to be active in ¢ys but is no 
longer there is terminated; a new process is created for each added line, lines unchanged in the 
file are undisturbed. Thus it is possible to drop or add phone lines without rebooting the sys- 
tem by changing the ys file and sending a hangu 


p signal to the init process: use ‘kill -HUP 1.’ 


[nit will terminate multi-user operations and resume single-user mode if sent a terminate 
(TERM) signal, i.e. ‘kill ~TERM 1°. If there are processes outstanding which are deadlocked 
(due to hardware or software failure), init will not wait for them all to die (which might take 
forever), but will time out after 30 seconds and print a warning message. 


[nit will cease creating new getry’s and allow the system to slowly die away, if it is sent a termi- 
nal stop (TSTP) signal, i.e. ‘*kill ~TSTP 1°*. A later hangup will resume full multi-user opera- 
tions, or a terminate will initiate a single user shell. This hook is used by reboor(8) and hair(8). 


Init’s role is so critical that if it dies, the system will reboot itself automatically. If, at bootstrap 
time, the init process cannot be located, the system will loop in user mode at location 0x13. 


DIAGNOSTICS 
init: my: cannot open. A terminal which is turned on in the rc file cannot be opened, likely 
because the requisite lines are either not configured into the system or the associated device 
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was not attached during boot-time system configuration. 


WARNING: Something is hung (wont die); ps axl advised A process is hung and could not 
be killed when the system was shutting down. This is usually caused by a process which is 
stuck in a device driver due to a persistent device error condition. 


FILES : 

| /dev/console, /dev/tty?, /etc/utmp, /usr/adm/wtmp, /etc/ttys, /etc/re 

SEE ALSO 
login(1), kill(1), sh(1), ttys(5), crash(8), getty(8), rc(8), reboot(8), halt(8), shutdown (8) 
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NAME 

makekey — generate encryption key 
SYNOPSIS 

/usr/lib/makekey 
DESCRIPTION 


Makekey improves the usefulness of encryption schemes depending on a key by increasing the 
arnount of time required to search the key space. It reads 10 bytes from its standard input, and 
writes 13 bytes on its standard output. The output depends on the input in a way intended to 
be difficult to compute (i.e. to require a substantial fraction of a second). 


The first eight input bytes (the inpur key) can be arbitrary ASCII characters. The last two (the 
salt) are best chosen from the set of digits, upper- and lower-case letters, and ‘.’ and ‘/’. The 
salt characters are repeated as the first two characters of the output. The remaining 11 output 
characters are chosen from the same set as the salt and constitute the ourput key. 


The transformation performed is essentially the following: the salt is used to select one of 4096 
cryptographic machines all based on the National Bureau of Standards DES algorithm, but 
modified in 4096 different ways. Using the input key as key, a constant string is fed into the 
machine and recirculated a number of times. The 64 bits that come out are distributed into the 
66 useful key bits in the result. 


Makekey is intended for programs that perform encryption (e.g. ed and crypt(1)). Usually its 
input and output will be pipes. 


SEE ALSO 


crypt(1), ed(1) 
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NAME 


mkfs — construct a file system 


SYNOPSIS 


/etc/mkfs special size [mn ] 
/etc/mkfs special proto 


DESCRIPTION 
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Mkfs constructs a file system by writing on the special file special. In the first form of the com- 
mand a numeric size is given and mkfs builds a file system with a single empty directory on it. 
The number of i-nodes is calculated as a function of the filesystem size. (No boot program is 
initialized in this form of mk/s.) 


N.B.: All filesystems should have a lost+/ound directory for fsck(8); this should be created for 
each file system by running mk/ost+/found(8) in the root directory of a newly created file sys- 
tem, after the file system is first mounted. 


In bootstrapping, the second form of m/s is sometimes used. In this form, the file system is 
constructed according to the directions found in the prototype file proto. The prototype file con- 
tains tokens separated by spaces or new lines. The first token is the name of a file to be copied 
onto sector zero as the bootstrap program. The second token is a number specifying the size of 
the created file system. Typically it will be the number of blocks on the device, perhaps dimin- 
ished by space for swapping. The next token is the number of i-nodes in the i-list. The next 
set of tokens comprise the specification for the root file. File specifications consist of tokens 
giving the mode, the user-id, the group id, and the initial contents of the file. The syntax of 
the contents field depends on the mode. 


The mode token for a file is a 6 character string. The first character specifies the type of the 
file. (The characters —bed specify regular, block special, character special and directory files 
respectively.) The second character of the type is either u or — to specify set-user-id mode or 
not. The third is gor — for the set-group-id mode. The rest of the mode is a three digit octal 
number giving the owner, group, and other read, write, execute permissions, see chmod(1). 


Two decimal number tokens come after the mode; they specify the user and group ID's of the 
owner of the file. 


If the file is a regular file, the next token is a pathname whence the contents and size are 
copied. 


If the file is a block or character special file, two decimal number tokens follow which give the 
major and minor device numbers. 


If the file is a directory, mkfs makes the entries . and .. and then reads a list of names and 
(recursively) file specifications for the entries in the directory. The scan is terminated with the 
token §% 


A sample prototype specification follows: 


/usr/mdec/uboot 
4872 55 
d--777 3 1 
usr d—-—-777 31 
sh ——-—755 3 1 /bin/sh 
ken d—--—-755 61 
$ 


bO b-—-6443100 
c0) c~—644 3100 
$ 
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The arguments m and n specify the interleave factor. M should always be 3 and you shouid 
use the following table to choose n. as follows. 


RMO3 80 

RMO5 304 
RM380 217 
RPO6 209 
RPO? 800 
SI/CDC 9766 304 
RKO? 33 


EMULEX/AMPEX 300M 304 
EMULEX/FUJITSU 160M 160 


SEE ALSO 
filsys(S), dir(5), fsck(8), mklost +found(8) 


BUGS 
There should be some way to specify links. 


There should be some way to specify bad blocks. 
Should make /ost+/found automatically. 
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NAME 

mklost+found — make a lost+found directory for fsck 
SYNOPSIS 

/ete/mklost + found 
DESCRIPTION 


A directory lost+/found is created in the current directory and a number of empty files are 
created therein and then removed so that there will be empty slots for fsck(8). This command 
should be run immediately after first mounting a newly created file system. 

SEE ALSO 
fsck(8), mkfs(8) 

BUGS 
Should be done automatically by mkfs. 
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NAME 

mknod — build special file 
SYNOPSIS 

/etc/mknod name [c¢] [ b ] major minor 
DESCRIPTION 


Mknod makes a special file. The first argument is the name of the entry. The second is b if the 
special file is block-type (disks, tape) or ¢ if it is character-type (other devices). The last two 
arguments are numbers specifying the major device type and the minor device (e.g. unit, drive, 
or line number). 


The assignment of major device numbers is specific to each system. They have to be dug out 
of the system source file confc. 


SEE ALSO 
mknod(2) 
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NAME 
mount, umount — mount and dismount file system 

SYNOPSIS 
/etc/mount [ special name [ —r ] ] 
/etc/mount —a 
/etc/umount special 
/etc/umount a 

DESCRIPTION 
Mount announces to the system that a removable file system is present on the device special. 
The file name must exist already; it must be a directory (unless the root of the mounted file 
system is not a directory). It becomes the name of the newly mounted root. The optional 
argument —r indicates that the file system is to be mounted read-only. 
Umount announces to the system that the removable file system previously mounted on device 
special is to be removed. 
If the —a option ts present for either mount or umount, all of the file systems described in 
/etc/fstab are attempted to be mounted or unmounted. In this case, specia/ and namie are taken 
from /erc/fstab. The special file name from /etc/fstab is the block special name. 
These commands maintain a table of mounted devices in /etc/mrab. If invoked without an argu- 
ment, mtount prints the table. 
Physically write-protected and magnetic tape file systems must be mounted read-only or errors 
will occur when access times are updated, whether or not any explicit write 1s attempted. 

FILES 
/ete/mtab mount table 
/etc/fstab file system table 

SEE ALSO 
mount(2), mtab(5), fstab(5) 

BUGS 


Mounting file systems full of garbage will crash the system. 
Mounting a root directory on a non-directory makes some apparently good pathnames invalid. 
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NAME 


ncheck — generate names from i-numbers 


SYNOPSIS 


/ete/ncheck [ —i numbers] [ —a] {—s] [ filesystem ] 


DESCRIPTION 


N.B.: For most normal file system maintenance, the function of mcheck is subsumed by fSsck(8). 


Neheck with no argument generates a pathname vs. i-number list of all files on a set of default 
file systems. Names of directory files are followed by ‘/.°. The —i option reduces the report to 
oniy those files whose i-numbers follow. The -a option allows printing of the names ‘.’ and 
*.., which are ordinarily suppressed. suppressed. The —s option reduces the report to special 
files and files with set-user-[D mode; it is intended to discover concealed violations of security 


policy. 
A file system may be specified. 
The report is in no useful order, and probably should be sorted. 


SEE ALSO 


sort(1), dcheck(8), fsck (8), icheck (8) 


DIAGNOSTICS 


When the filesystem structure is improper, ‘??’ denotes the ‘parent’ of a parentiess file and a 
pathname beginning with ‘...’ denotes a loop. 
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NAME 
old — directory of old programs 


SYNOPSIS 
/usr/old/bin 
/usr/old/include 
/usr/old/lib 


/usr/old/ce —I/usr/old/include ... 

DESCRIPTION | 
After the 3rd Berkeley Distribution, the formats for binary and archive files were changed. The 
binaries were modified to allow arbitrary length symbols, which required adding a string table at 
the end of the symbol table, and having symbol table entries point into the names in that table. 
The archive was modified to be a portable format, using strings instead of binary numbers, to 


avoid problems of different sizes of integers on different machines. These changes are incom- 
patible with older formats. 


/usr/old is the root of a hierarchy of binaries, include files, and libraries in the old binary and 
archive formats. They contain a complete set of programs and files necessary for people who 
need to deal with the original UNIX formats. 


In order to create new binaries in the old format, one must include the right header files. For 
example, to create a program called ‘‘foo’’ which uses the old math library in the old format, 
say 


/usr/old/ce —I/usr/old/include [ flags] foo.c —Im 


SEE ALSO 
arcv(8), ar(1), cc(1), a.out(5), ar(S) 


BUGS 
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NAME 

pstat — print system facts 
SYNOPSIS 

/ete/pstat { —aixptufT ] [ suboptions | [ file ] 
DESCRIPTION 


Pstat interprets the contents of certain system tables. If file is given, the tables are sought 
there, otherwise in /dev/kmem. The required namelist is taken from Amunix. Options are 


~s Under —p, describe ail process slots rather than just active ones. 
a | Print the inode table with the these headings: 


LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 
L locked 
U update time (Alsys(S)) must be corrected 
A access time must be corrected 
M file system is mounted here 
WwW wanted by another process (L flag is on) 
T contains a text file 
Cc changed time must be corrected 
CNT Number of open file table entries for this inode. 
DEV Major and minor device number of file system in which this inode resides. 
INO I-number within the device. | 
MODE Mode bits, see chmoa(2). 
NLK Number of links to this inode. 
UID User ID of owner. 
SIZ/ DEV 
Number of bytes in an ordinary file, or major and minor device of special file. 


—X Print the text table with these headings: 


LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus: 

ptrace(2) in effect 

text not yet written on swap device 

loading in progress 

locked 

wanted (L flag is on) 

resulted from demand-page-from-inode exec format (see exec(2)) 


wvVeERrges 


DADDR Disk address in swap, measured in multiples of 512 bytes. 
CADDR Head of a linked list of loaded processes using this text segment. 
SIZE Size of text segment, measured in multiples of 512 bytes. 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text segment. 


~p Print process table for active processes with these headings: 
LOC The core location of this table entry. 
S Run state encoded thus: 

0 ' MO process 

l waiting for some event 

3 runnable 
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POIP 
PRI 


SIZE 


LINK 
TEXTP 
CLKT 


4 
5 
6 
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being created 
being terminated 
stopped under trace 


Miscellaneous state variables, or-ed together (hexadecimal): 


200000 


loaded 

the scheduler process 

locked for swap out 

swapped out 

traced 

used in tracing 

locked in by /ock(2). 

in page-wait 

prevented from swapping during fork(2) 

gathering pages for raw i/o 

exiting 

process resulted from a vfork(2) which is not yet complete 

another flag for vfork(2) 

process has no virtual memory, as it is a parent in the context of vfork(2) 
process is demand paging data pages from its text inode. 

process has advised of anomalous behavior with vadvise(2). 

process has advised of sequential behavior with vadvise(2). 

process is in a sleep which will timeout. 

a parent of this process has exited and this process is now considered 
detached. 

process used some new signal primitives, i.e. sigser(3),; more systern calls 
will restart. 

process is owed a profiling tick. 


number of pages currently being pushed out from this process. 

Scheduling priority, see nice(2). 

SIGNAL Signals received (signals 1-32 coded in bits 0-31), 

Real user ID. 

Amount of time process has been blocked. 

Time resident in seconds; times over 127 coded as 127. 

Weighted integral of CPU time, for scheduler. 

Nice level, see nice(2). 

Process number of root of process group (the opener of the controlling terminal). 
The process ID number. 

The process ID of parent process. 

If in core, the page frame number of the first page of the ‘u-area’ of the process. if 
swapped out, the position in the swap area measured in multiples of 512 bytes. 
Resident set size — the number of physical page frames allocated to this process. 
RSS at last swap (0 if never swapped). 

Virtual size of process image (data+stack) in multiples of 512 bytes. 

WCHAN Wait channel number of a waiting process. 

Link pointer in list of runnable processes. 

If text is pure, pointer to location of text table entry. 

Countdown for alarm(2) measured in seconds. 


Print table for terminals with these headings: 


Number of characters in raw input queue. 
Number of characters in canonicalized input queue. 


Number of characters in putput queue. 
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ADDR Physical device address. 

DEL Number of delimiters (newlines) in canonicalized input queue. 

COL Calculated column position of terminal. 

STATE Miscellaneous state variables encoded thus: 

waiting for open to complete 

open 

has special (output) start routine 

carrier is on 

busy doing output 

process is awaiting output 

open for exclusive use 

hangup on close 

PGRP Process group for which this is controlling terminal. 

DISC Line discipline; blank is old tty OTTYDISC or ‘‘new tty’? for NTTYDISC or ‘“‘net” 
for NETLDISC (see 6k(4)). 


~uU print information about a user process; the next argument is its address as given by 
ps(1). The process must be in main memory, or the file used can be a core image 
and the address 0. 


Tx>WONO s 


~f Print the open file table with these headings: 
LOC The core location of this table entry. 
FLG Miscellaneous state variables encoded thus: 
R open for reading 
WwW open for writing 
P pipe 


CNT Number of processes that know this open file. 
INO The location of the inode table entry for this file. 
OFFS The file offset, see lseek(2). 


—s print information about swap space usage: the number of (1k byte) pages used and free is 
given as well as the number of used pages which belong to text images. 


—T prints the number of used and free slots in the several system tables and is useful for 
checking to see how full system tables have become if the system is under heavy load. —-m 
and -g flags print the multiplexor tables. These tables are rather difficult to explain. The 
potential explorer should examine the multiplexor code in the system. 


FILES 
/vymunix namelist 
/dev/kmem. default source of tables 


SEE ALSO 
ps(1), stat(2), filsys(S) 
K. Thompson, UNIX Implementation 
BUGS : 
It would be very useful if the system recorded ‘“‘maximum occupancy’ on the tables reported 
by —T; even more useful if these tables were dynamically allocated. 
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NAME 

quot — summarize file system ownership 
SYNOPSIS 

/ete/quot [ option ] ... [ filesystem ] 
DESCRIPTION 


Quot prints the number of blocks in the named filesystem currently owned by each user. If no 
filesystem is named, a default name is assumed. The following options are available: 


—n Cause the pipeline ncheck filesystem | sort +0n | quot —n filesystem to produce a list 
of all files and their owners. 


—¢ Print three columns giving file size in blocks, number of files of that size, and cumula- 
tive total of blocks in that size or smaller file. 
—f Print count of number of files as well as space owned by each user. 


FILES 
Default file system varies with system. 
/etc/passwd to get user names 


SEE ALSO 
Is(1), du(1) 


BUGS 
Holes in files are counted as if they actually occupied space. 
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NAME 
rc - command script for auto-reboot and daemons 


SYNOPSIS 
/etc/re 


DESCRIPTION 
Reis the command script which controls the automatic reboot 


When an automatic reboot is in progress, rcis invoked with the argument a@uroboor and runs a 
Jsck with option —p to “‘preen’’ all the disks of minor inconsistencies resulting from the last 
system shutdown and to check for serious inconsistencies caused by hardware or software 
failure. If this auto-check and repair succeeds, then the second part of rcis run. 


The second part of rc, which is run after a auto-reboot succeeds and also if rcis invoked when a 
single user shell terminates (see init(8)), starts all the daermons on the system, preserves editor 
files and clears the scratch directory /tmp. 


SEE ALSO 
init(8), reboot (8) 


BUGS 
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NAME 

reboot — UNIX bootstrapping procedures 
SYNOPSIS 

/etc/reboot [ —n] [ —q] 
DESCRIPTION 


UNIX is started by placing it in memory at location zero and transferring to zero. Since the 


system is not reenterable, it is necessary to read it in from disk or tape each time it is to be 
dbootstrapped. 


Rebooting a running system. When a UNIX is running and a reboot is desired, shurdown(8) is 
normally used. If there are no users then /etc/reboot can be used. Reboot causes the disks to 
be synced, and then a multi-user reboot (as described below) is initiated. This causes a system 
to be booted and an automatic disk check to be performed. If all this succeeds without 
incident, the system is then brought up for many users. 


Options to reboot are: 


—nD option avoids the sync. It can be used if a disk or the processor is on fire. (It is no 
longer necessary to reboot after rebuilding the root file system.) 


—q reboots quickly and ungracefully, without shutting down running processes first. 


Power fail and crash recovery. Normally, the system will reboot itself at power-up or after 
crashes. Provided the auto-restart is enabled on the machine front panel, an automatic con- 


sistency check of the file systems will be performed then and unless this fails the system will 
resume multi-user operations. 


Cold starts. These are processor type dependent. On an 11/780, there are two floppy files for 
each disk controller, both of which cause boots from unit 0 of the root file system of a con- 
troller located on mba0 or uba0. One gives a single user shell, while the other invokes the 
multi-user automatic reboot. Thus these files are HPS and HPM for the single and multi-user 
boot from MASSBUS RP06/RM03/RMO05 disks, UPS and UPM for UNIBUS storage module 


controller and disks such as the EMULEX SC-21 and AMPEX 9300 pair, or HKS and HKM for 
RK07 disks. 


Giving the command 
> >>BOOT HPM 


Would boot the system from (e.g.) an RPO6 and run the automatic consistency check as 
described in fsck(8). (Note that it may be necessary to type control-P to gain the attention of 
the LSI-11 before getting the >>> prompt.) The command 


>>>BOOT ANY 
invokes a version of the boot program in a way which allows you to specify any system as the 


system to be booted. It reads from the console a device specification (see below) followed 
immediately by a pathname. 


On an 11/750, the reset button will boot from the device selected by the front panel boot dev- 
ice switch. In systems with RKO7’s, position B normally selects the RKO7 for boot. This will 
boot multi-user. To boot from RKO7 with boot flags you may specify 

>>>B/nDMAO 


where, giving a 1 of 1 causes the boot program to ask for the name of the system to be 
bootstrapped, giving a mof 2 causes the boot program to come up single user, and a nz of 3 
causes both of these actions to occur. 
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The 11/750 boot procedure uses the boot roms to load block 0 off of the specified device. The 
fusr/mdec directory contains a number of bootstrap programs for the various disks which 
should be placed in a new pack via 


cp /usr/mdec/ x»xxboot /dev/ xx" 


whenever a new bootable pack is to be created. 


On both processors, the door program finds the corresponding file on the given device, loads 
that file into memory location zero, and starts the program at the entry address specified in the 
program header (after clearing off the high bit of the specified entry address.) Normal line edit- 
ing characters can be used in specifying the pathname. 


If you have an rp06, rm0S5 or rm03 disk and wish to boot off of a file system which starts at 
cylinder 0 of unit 0, you can type *thp(0,0)vmunix"’ to the boot prompt, ‘“‘up(0,0)vmunix™ 
would specify a UNIBUS ampex 9300 drive, ‘‘rk(0,0)vmunix’’ would specify a RK-0O7 disk 


drive. 


A device specification has the following form: 
device (unit, minor) 


where device is the type of the device to be sgh unitis 8* the mba or uba number plus the 
unit number of the device, and minor is the minor device index. The following list of sup- 
ported devices may vary from installation to installation: 
up storage mod drive UNIB 
ht TE16, TU4S, ruTT, on M 
hk neu! on UNIBUS 
tm TM11 emulation tape drives on UNIBUS 
ts TS on UNIBUS 


For tapes, the minor device number gives a file offset. 


58 


In an emergency, the bootstrap methods described in the paper ‘‘Setting up the Fourth Berke- 
ley Software Tape’ can be used io boot from a distribution tape. 
FILES 
/yvmunix system code 
/boot system bootstrap 


SEE ALSO 
crash(8), fsck (8), init(8), re(8), shutdown (8), halt (8) 
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NAME 

renice — alter priority of running process by changing nice 
SYNOPSIS 

/etc/renice pid [ priority ] 
DESCRIPTION 


Renice can be used by the super-user to alter the priority of a running process. By default, the 
nice of the process is made ‘19’ which means that it will run only when nothing else in the 
system wants to. This can be used to nail long running processes which are interfering with 
interactive work. 


Renice can be given a second argument to choose a nice other than the default. Negative nices 
can be used to make things go very fast. 


FILES 
/vmunix 
/dev/kmem 


SEE ALSO 
nice (1) 

BUGS 
If you make the nice very negative, then the process cannot be interrupted. To regain control 
you must put the nice back (e.g. to 0.) 
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NAME 

restor ~ incremental file system restore 
SYNOPSIS 

/ete/restor key | argument ... | 
DESCRIPTION 


Restor is used to read magtapes dumped with the dump command. The key specifies what is to 
be done. Key is one of the characters rRxt optionally combined with f. 


f Use the first argument as the name of the tape instead of the default. 


ror R The tape ts read and loaded into the file system specified in argument. This should not 
be done lightly (see below). If the key is R restor asks which tape of a multi volume 
set to start on. This allows restor to be interrupted and then restarted (an icheck —s 
must be done before restart). 


x Each file on the tape named by an argument is extracted. The file extracted is placed in 
a file with a mumeric name supplied by restor (actually the inode number). In order to 
keep the amount of tape read to a minimum, the following procedure ts recommended: 


Mount volume | of the set of dump tapes. 
Type the restor command. 


Restor will announce whether or not it found the files, give the number it will name the 
file, and rewind the tape. 


It then asks you to ‘mount the desired tape volume’. Type the number of the volume 
you choose. On a multivolume dump the recommended procedure is to mount the last 
through the first volume in that order. Restor checks to see if any of the files requested 
are on the mounted tape (or a later tape, thus the reverse order) and doesn’t read 
through the tape if no files are. If you are working with a single volume dump or the 
number of files being restored is large, respond to the query with ‘1° and restor will read 
the tapes in sequential order. 


If you have a hierarchy to restore you can use dumpdir(8) to produce the list of names 
and a shell script to move the resulting files to their homes. 
t Print the date the tape was written and the date the filesystem was dumped from. 


The r option shouid only be used to restore a complete dump tape onto a clear file system or to 
restore an incremental dump tape onto this. Thus 


/etc/mkfs /dev/rrp0g 145673 
restor r /dev/rrp0g 


is a typical sequence to restore a complete dump. Another resfor can be done to get an incre- 
mental dump in on top of this. 


A dump followed by a mk/s and a resfor is used to change the size of a file system. 


FILES 
default tape unit varies with installation 
rst= 


SEE ALSO 
dump(8), mkfs(8), dumpdir(8) 


DIAGNOSTICS 
There are various diagnostics involved with reading the tape and writing the disk. There are 
also diagnostics if the i-list or the free list of the file system is not large enough to hold the 
dump. 
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If the dump extends over more than one tape, it may ask you to change tapes. Reply with a 
new-line when the next tape has been mounted. 


BUGS 


There is redundant information on the tape that could be used in case of tape reading problems. 
Unfortunately, restor doesn’t use it. 
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NAME 
sa, accton — system accounting 


SYNOPSIS 
/ete/sa [ ~abcdDfijkKlorstuv | [ file ] 


/etc/accton [ file } 


DESCRIPTION 
With an argument naming an existing file, accton causes system accounting information for 
every process executed to be placed at the end of the file. If no argument is given, accounting 
is turned off. 


Sa reports on, cleans up, and generally maintains accounting files. 


Sa is able to condense the information in /usr/adm/acct into a summary file Assr/adm/savacct 
which contains a count of the number of times each command was called and the time 
resources consumed. This condensation is desirable because on a large system /usr/adm/acct can 
grow by 100 blocks per day. The summary file is Souraily read before the accounting file, so 
the reports include all available information. 


If a file name is given as the last argument, that file will be treated as the accounting file; 
/usriadm/acct is the default. 


Output fields are labelled: ‘‘cpu’’ for the sum of user+system time (in minutes), ‘‘re’’ for real 
time (also in minutes), ‘tk’’ for cpu-time averaged core usage (in 1k units), ‘‘avio’’ for average 
number of i/o operations per execution. With options fields labelled ‘‘tio’’ for total i/o opera- 
tions, ‘“‘kesec’’ for cpu storage integral (kilo-core seconds), ‘‘u’’ and ‘‘s’’ for user and system 
cpu time alone (both in minutes) will sometimes appear. 


There are near a googol of options: 


a Piace all command names containing unprintable characters and those used only once 
under the name ‘**sother.’ 


b Sort output by sum of user and system time divided by number of calls. Default sort is 
by sum of user and system times. 


Cc Besides total user, system, and real time for each command print percentage of total 
time over all commands. 

d Sort by average number of disk i/o operations. 

D Print and sort by total number of disk i/o operations. 

f Force no interactive threshold compression with —v flag. 

i Don’t read in summary file. 

j Instead of total minutes time for each category, give seconds per call. 
Sort by cpu-time average memory usage. 

K Print and sort by cpu-storage integral. 

l Separate system and user time; normally they are combined. 

m Print number of processes and number of CPU minutes for each user. 

n Sort by number of calls. 

r Reverse order of sort. 

S Merge accounting file into summary file Ausr/adm/savacct when done. 
For each command report ratio of real time to the sum of user and system times. 

u Superseding all other flags, print for each command in the accounting file the user ID 
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and command name. 


Vv Followed by a number a, types the name of each command used an times or fewer. 
Await a reply from the terminal; if it begins with ‘y’, add the command to the category 
‘ssjunk**,’ This is used to strip out garbage. 


FILES 
/usr/adm/acct raw accounting 
/ust/adm/savacct summary 
/usr/adm/usracct per-user summary 
SEE ALSO 


ac(8), acct(2) 
BUGS 
The number of options to this program is absurd. 
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NAME 

Ssavecore — save a core dump of the operating system 
SYNOPSIS 

savecore dirname 
DESCRIPTION 


Savecore is meant to be called at the end of the /etc/rc file. Its function is to save the core 
dump of the system (assuming one was made) and to write a reboot message in the shutdown 
log. 


Savecore checks the core dump to be certain it corresponds with the current running unix. If it 
does it saves the core image in the file dirname/vmcore.n and it’s brother, the namelist, 
dirname/vmunix.n The trailing *.n" in the pathnames is replaced by a number which grows 
every time savecore is run in that directory. 


Before savecore writes out a core image, it reads a number from the file dirname/minfree. If 
there are fewer free blocks on the filesystem which contains dirname than the number obtained 
from the minfree file, the core dump is not done. If the minfree file does not exist, savecore 
always writes out the core file (assuming that a core dump was taken). 


Savecore also writes a reboot message in the shut down log. If the system crashed as a result of 
a panic, savecore records the panic string in the shut down log too. 


FILES 
/usr/adm/shutdownlog Shut down log 
/vmunix Current UNIX 


BUGS 
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NAME 


shutdown — close down the system at a given time 


SYNOPSIS 


/ete/shutdown { —k] {[ —r] { —h] time [ warning-message ... ] 


DESCRIPTION 


FILES 


Shutdown provides an automated shutdown procedure which a super-user can use to notify 
users nicely when the system is shutting down, saving them from system administrators, hack- 
ers, and gurus, who would otherwise not bother with niceties. 


Time is the time at which shutdown will bring the system down and may take two formats: 
+number and hour:min. The first form brings the system down in number minutes and the 
second brings the system down at the time of day indicated (as a 24—hour clock). 


At intervals which get closer together as apocalypse approaches, warning messages are displayed 
at the terminals of all users on the system. Five minutes before shutdown, or immediately if 
shutdown is in less than 5 minutes, logins are disabled by creating /etc/nologin and writing a 
message there. If this file exists when a user logs in, /ogin(1) prints its contents and exits. The 
file is removed just before shutdown exits. 


At shutdown time a message is written in the file /usr/adm/shutdownlog, containing the time 
of shutdown, who ran shutdown and the reason. Then a terminate signal is sent at initto bring 
the system down to single-user state. Alternatively, if -r, -h, or -k was used, then shutdown 
will exec reboort(8), Aalt(8), or avoid shutting the system down (respectively). (If it isn’t obvi- 
ous, ~k is to make people think the system is going down!) 


The time of the shutdown and the warning message are placed in /etc/nologin and should be 
used to inform the users about when the system will be back up and why it is going down (or 
anything else). 


/etc/nologin tells login not to let anyone log in 
/usr/adm/shutdownlog log file for succesful shutdowns. 


SEE ALSO 


BUGS 


login(1), reboot (8) 


Only allows you to kill the system between now and 23:59 if you use the absolute time for 
shutdown. 


Times to shutdown are not nice and round, i.e. ‘‘shutdown in 18 seconds”’. 
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NAME 


sticky — executable files with persistent text 


DESCRIPTION 


BUGS 


While the ‘sticky bit’, mode 01000 (see chmod(2)), is set on a sharable executable file, the text 
of that file will not be removed from the system swap area. Thus the file does not have to be 
fetched from the file system upon each execution. As long as a copy remains in the swap area, 
the original text cannot be overwritten in the file system, nor can the file be deleted. (Direc- 
tory entries can be removed so long as one link remains.) 


Sharable files are made by the ~n and —z options of /d(1). 


To replace a sticky file that has been used do: (1) Clear the sticky bit with chmod(1). (2) Exe- 
cute the old program to flush the swapped copy. This can be done safely even if others are 
using it. (3) Overwrite the sticky file. If the file is being executed by any process, writing will 
be prevented; it suffices to simply remove the file and then rewrite it, being careful to reset the 
owner and mode with chmod and chown(2). (4) Set the sticky bit again. 


Only the super-user can set the sticky bit. 


Are self-evident. 


Is largely unnecessary on the VAX; matters only for large programs that will page heavily to 
start, Since text pages are normally cached incore as long as possible after all instances of a text 
image exit. 
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NAME 
swapon — specify additional device for paging and swapping 

SYNOPSIS 
/etc/swapon —a 
/etc/swapon name ... 

DESCRIPTION 
Swapon is used to specify additional devices on which paging and swapping are to take place. 
The system begins by swapping and paging on only a single device so that only one disk ts 
required at bootstrap time. Calls to swepon normally occur in the system multi-user initializa- 


tion file /etc/rc making all swap devices available, so that the paging and swapping activity 1s 
interleaved across several devices. 


Normally, the —a argument is given, causing all devices marked as ‘“‘sw’’ swap devices in 
/etc/fstab to be made available. 


The second form gives individual block devices as given in the system swap configuration table. 
The call makes only this space available to the system for swap allocation. 

SEE ALSO 
swapon(2), init(8) 

FILES 
/dev/{ru] [pk] ?b normal paging devices 

BUGS 
There is no way to stop paging and swapping on a device. It is therefore not possible to make 
use of devices which may be dismounted during system operation. 
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NAME 

sync — update the super block 
SYNOPSIS 

sync 


DESCRIPTION 
Sync executes the sync system primitive. Sync can be called to insure all disk writes have been 
completed before the processor is halted in a way not suitably done by reboot(8) or fair(8). 


See sync(2) for details on the system primitive. 


SEE ALSO 
syne(2), halt(8), reboot(&), update (8) 
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NAME 

update — periodically update the super block 
SYNOPSIS 

/etc/update 
DESCRIPTION 


Update is a program that executes the sync(2) primitive every 30 seconds. This insures that the 
file system is fairly up to date in case of a crash. This command should not be executed 
directly, but should be executed out of the initialization shell command file. 

SEE ALSO 
sync(2), sync(1), init(8) 

BUGS 
With update running, if the CPU is halted just as the sync is executed, a file system can be dam- 
aged. This is partially due to DEC hardware that writes zeros when NPR requests fail. A fix 
would be to have sync(1) temporarily increment the system time by at least 30 seconds to 
trigger the execution of update. This would give 30 seconds grace to halt the CPU. 
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NAME 
vipw — edit the password file with vi 


SYNOPSIS 
vipw 
DESCRIPTION 
Vipw edits the password file while setting the appropriate locks, and does any necessary process- 


ing after the password file is unlocked. If the password file is already being edited, then you 
will be told to try again later 


SEE ALSO 
chfn(1), chsh(1), passwd(1), passwd(5), adduser (8) 


FILES 
/etc/vipw.lock 


BUGS 
Vipw does not remove the vipw.lock file; this is not a bug, but people tend to think if is. 


No one deals with left-over /etc/ptmp (the real lock) files after a system crash. 
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NAME 

vpac — print raster printer/ploter accounting information 
SYNOPSIS | 

/ete/vpac [ ~-W] [—s][—r] [—t] [ name... ] 
DESCRIPTION 


Vpac reads the raster printer/plotter accounting files, accumulating the number of pages (for 
narrow fan-fold devices) or feet (for wide, roll paper devices) of paper consumed by each user, 
and printing out how much each user consumed in pages or feet and dollars (billed at 2 cents / 
page or 8 cents / foot). If any mames are specified, then statistics are only printed for those 
users; uSually, statistics are printed for every user who has used any paper. 


The —W flag causes accounting to be done for a wide roll paper device. The default is to do 
accounting for a narrow, fan-fold device. The —t flag causes the output to be sorted by feet of 
paper; usually the output is sorted alphabetically by name. The -—r flag reverses the sorting 
order. The -s flag causes the accounting information to be summarized on the summary 
accounting file; this summarization is necessary since on a busy system, the accounting file can 
grow by several lines per day. 


FILES 
/usr/adm/v ?acct raw accounting files 
/usr/adm/v?_sum summary accounting files 
BUGS 
The relationship between the computed price and reality is as yet unknown. 
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